documentation/panel/1.0/upgrading.html
2021-02-15 00:05:59 +00:00

64 lines
18 KiB
HTML

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Upgrading | Pterodactyl</title>
<meta name="generator" content="VuePress 1.5.4">
<link rel="apple-touch-icon" sizes="180x180" href="/favicons/apple-touch-icon.png">
<link rel="icon" type="image/png" href="/favicons/favicon-32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="/favicons/favicon-16x16.png" sizes="16x16">
<link rel="mask-icon" href="/favicons/safari-pinned-tab.svg" color="#0e4688">
<link rel="manifest" href="/favicons/manifest.json">
<link rel="shortcut icon" href="/favicons/favicon.ico">
<meta name="description" content="The open-source server management solution.">
<meta name="msapplication-config" content="/favicons/browserconfig.xml">
<meta name="theme-color" content="#0e4688">
<link rel="preload" href="/assets/css/0.styles.6fa99e09.css" as="style"><link rel="preload" href="/assets/js/app.efb94fbf.js" as="script"><link rel="preload" href="/assets/js/4.e413141f.js" as="script"><link rel="preload" href="/assets/js/1.ee4ff4e2.js" as="script"><link rel="preload" href="/assets/js/70.8dd44fe5.js" as="script"><link rel="prefetch" href="/assets/js/10.041c438a.js"><link rel="prefetch" href="/assets/js/11.efec8f80.js"><link rel="prefetch" href="/assets/js/12.7214ee65.js"><link rel="prefetch" href="/assets/js/13.7b958e39.js"><link rel="prefetch" href="/assets/js/14.3700aaa2.js"><link rel="prefetch" href="/assets/js/15.43153aa4.js"><link rel="prefetch" href="/assets/js/16.90c5b55f.js"><link rel="prefetch" href="/assets/js/17.f2ef94ea.js"><link rel="prefetch" href="/assets/js/18.2e49d336.js"><link rel="prefetch" href="/assets/js/19.6b7a12e9.js"><link rel="prefetch" href="/assets/js/2.f895a645.js"><link rel="prefetch" href="/assets/js/20.a8186273.js"><link rel="prefetch" href="/assets/js/21.7d0bf491.js"><link rel="prefetch" href="/assets/js/22.ff372b4a.js"><link rel="prefetch" href="/assets/js/23.6388ee5d.js"><link rel="prefetch" href="/assets/js/24.433197bc.js"><link rel="prefetch" href="/assets/js/25.f87fba53.js"><link rel="prefetch" href="/assets/js/26.e0451f04.js"><link rel="prefetch" href="/assets/js/27.778d7f34.js"><link rel="prefetch" href="/assets/js/28.653b63a6.js"><link rel="prefetch" href="/assets/js/29.895e3725.js"><link rel="prefetch" href="/assets/js/30.c937ce7b.js"><link rel="prefetch" href="/assets/js/31.12a37f92.js"><link rel="prefetch" href="/assets/js/32.ebe99c03.js"><link rel="prefetch" href="/assets/js/33.e1838ab2.js"><link rel="prefetch" href="/assets/js/34.6788ea1f.js"><link rel="prefetch" href="/assets/js/35.12687306.js"><link rel="prefetch" href="/assets/js/36.b55749f6.js"><link rel="prefetch" href="/assets/js/37.03135ad8.js"><link rel="prefetch" href="/assets/js/38.c0059690.js"><link rel="prefetch" href="/assets/js/39.5a8f2652.js"><link rel="prefetch" href="/assets/js/40.d63a99ee.js"><link rel="prefetch" href="/assets/js/41.f3ddbe24.js"><link rel="prefetch" href="/assets/js/42.20c949e2.js"><link rel="prefetch" href="/assets/js/43.5569655e.js"><link rel="prefetch" href="/assets/js/44.7df07373.js"><link rel="prefetch" href="/assets/js/45.bd7ba52f.js"><link rel="prefetch" href="/assets/js/46.8ab282e9.js"><link rel="prefetch" href="/assets/js/47.75d21fa7.js"><link rel="prefetch" href="/assets/js/48.ff554eb8.js"><link rel="prefetch" href="/assets/js/49.a1a8ccd8.js"><link rel="prefetch" href="/assets/js/5.1bddf890.js"><link rel="prefetch" href="/assets/js/50.0ff5425f.js"><link rel="prefetch" href="/assets/js/51.9d0817fd.js"><link rel="prefetch" href="/assets/js/52.3486b1ed.js"><link rel="prefetch" href="/assets/js/53.ee081f66.js"><link rel="prefetch" href="/assets/js/54.cb3a1a7e.js"><link rel="prefetch" href="/assets/js/55.17a8afef.js"><link rel="prefetch" href="/assets/js/56.9477714d.js"><link rel="prefetch" href="/assets/js/57.13409baa.js"><link rel="prefetch" href="/assets/js/58.5ff02f81.js"><link rel="prefetch" href="/assets/js/59.25e773f7.js"><link rel="prefetch" href="/assets/js/6.d7837586.js"><link rel="prefetch" href="/assets/js/60.7ec6926f.js"><link rel="prefetch" href="/assets/js/61.a44ed8e0.js"><link rel="prefetch" href="/assets/js/62.7f84d180.js"><link rel="prefetch" href="/assets/js/63.da0ad056.js"><link rel="prefetch" href="/assets/js/64.91b02e66.js"><link rel="prefetch" href="/assets/js/65.78d56c27.js"><link rel="prefetch" href="/assets/js/66.79138a6f.js"><link rel="prefetch" href="/assets/js/67.8f4ed01f.js"><link rel="prefetch" href="/assets/js/68.afe3b4b3.js"><link rel="prefetch" href="/assets/js/69.64223e2f.js"><link rel="prefetch" href="/assets/js/7.ad189dcf.js"><link rel="prefetch" href="/assets/js/71.68b2bd22.js"><link rel="prefetch" href="/assets/js/72.8b910c00.js"><link rel="prefetch" href="/assets/js/73.4bb789f2.js"><link rel="prefetch" href="/assets/js/74.423c0efe.js"><link rel="prefetch" href="/assets/js/75.ddc2c486.js"><link rel="prefetch" href="/assets/js/76.40d6e329.js"><link rel="prefetch" href="/assets/js/77.2d204f9a.js"><link rel="prefetch" href="/assets/js/78.e49870cd.js"><link rel="prefetch" href="/assets/js/8.f208d3ff.js"><link rel="prefetch" href="/assets/js/9.56fc48a0.js">
<link rel="stylesheet" href="/assets/css/0.styles.6fa99e09.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="nav"><div class="sidebar-button block md:hidden flex-no-shrink"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <div class="logo-container"><a href="/" class="home-link router-link-active"><img src="/pterodactyl-flat.png" class="logo"> <span class="site-name hidden md:inline can-hide">Pterodactyl</span></a></div> <div class="w-full"><div class="flex"><div class="search-box"><input aria-label="Search" placeholder="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links flex-no-shrink hidden md:flex"><div class="nav-item"><a href="/project/introduction.html" class="nav-link">Documentation
</a></div><div class="nav-item"><a href="/community/about.html" class="nav-link">Community Guides
</a></div><div class="nav-item"><a href="https://pterodactyl.io/discord" target="_blank" rel="noopener noreferrer" class="nav-link external">
Get Help
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div><div class="nav-item"><a href="https://dashflo.net/docs/api/pterodactyl/v1/" target="_blank" rel="noopener noreferrer" class="nav-link external">
API
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
Contribute
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div></nav></div></div></header> <div class="sidebar-mask"></div> <div class="sidebar"><nav class="nav-links flex-no-shrink block md:hidden"><div class="nav-item"><a href="/project/introduction.html" class="nav-link">Documentation
</a></div><div class="nav-item"><a href="/community/about.html" class="nav-link">Community Guides
</a></div><div class="nav-item"><a href="https://pterodactyl.io/discord" target="_blank" rel="noopener noreferrer" class="nav-link external">
Get Help
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div><div class="nav-item"><a href="https://dashflo.net/docs/api/pterodactyl/v1/" target="_blank" rel="noopener noreferrer" class="nav-link external">
API
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
Contribute
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div></nav> <ul class="sidebar-links"><li><div class="sidebar-group first"><p class="sidebar-heading open"><span>Project Information</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/project/introduction.html" class="sidebar-link">Introduction</a></li><li><a href="/project/about.html" class="sidebar-link">About</a></li><li><a href="/project/terms.html" class="sidebar-link">Terminology</a></li><li><a href="/project/community.html" class="sidebar-link">Community Standards</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Panel</span> <!----> <div tabindex="0" class="version-select custom-select float-right"><div class="selected"><div class="inline-block">
1.0
<span class="rounded-full ml-2 text-green-dark">current</span></div> <span class="arrow"></span></div> <div class="items hidden"><div class="item"><div class="inline-block">
0.7
<span class="rounded-full ml-2 text-grey">legacy</span></div></div><div class="item"><div class="inline-block">
1.0
<span class="rounded-full ml-2 text-green-dark">current</span></div></div></div></div></p> <ul class="sidebar-group-items"><li><a href="/panel/1.0/getting_started.html" class="sidebar-link">Getting Started</a></li><li><a href="/panel/1.0/webserver_configuration.html" class="sidebar-link">Webserver Configuration</a></li><li><a href="/panel/1.0/upgrading.html" class="active sidebar-link">Upgrading</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/panel/1.0/upgrading.html#maintenance-mode" class="sidebar-link">Maintenance Mode</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/upgrading.html#restarting-queue-workers" class="sidebar-link">Restarting Queue Workers</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/upgrading.html#version-specific-guides" class="sidebar-link">Version Specific Guides</a></li></ul></li><li><a href="/panel/1.0/additional_configuration.html" class="sidebar-link">Additional Configuration</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Wings</span> <!----> <div tabindex="0" class="version-select custom-select float-right"><div class="selected"><div class="inline-block">
1.0
<span class="rounded-full ml-2 text-green-dark">current</span></div> <span class="arrow"></span></div> <div class="items hidden"><div class="item"><div class="inline-block">
1.0
<span class="rounded-full ml-2 text-green-dark">current</span></div></div></div></div></p> <ul class="sidebar-group-items"><li><a href="/wings/1.0/installing.html" class="sidebar-link">Installing Wings</a></li><li><a href="/wings/1.0/upgrading.html" class="sidebar-link">Upgrading Wings</a></li><li><a href="/wings/1.0/migrating.html" class="sidebar-link">Migrating to Wings</a></li><li><a href="/wings/1.0/configuration.html" class="sidebar-link">Additional Configuration</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Daemon</span> <!----> <div tabindex="0" class="version-select custom-select float-right"><div class="selected"><div class="inline-block">
0.6
<span class="rounded-full ml-2 text-grey">legacy</span></div> <span class="arrow"></span></div> <div class="items hidden"><div class="item"><div class="inline-block">
0.6
<span class="rounded-full ml-2 text-grey">legacy</span></div></div></div></div></p> <ul class="sidebar-group-items"><li><a href="/daemon/0.6/installing.html" class="sidebar-link">Installation</a></li><li><a href="/daemon/0.6/upgrading.html" class="sidebar-link">Upgrading</a></li><li><a href="/daemon/0.6/configuration.html" class="sidebar-link">Additional Configuration</a></li><li><a href="/daemon/0.6/kernel_modifications.html" class="sidebar-link">Kernel Modifications</a></li><li><a href="/daemon/0.6/debian_8_docker.html" class="sidebar-link">Docker on Debian 8</a></li><li><a href="/daemon/0.6/standalone_sftp.html" class="sidebar-link">Standalone SFTP Server</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Tutorials</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/tutorials/mysql_setup.html" class="sidebar-link">Setting up MySQL</a></li><li><a href="/tutorials/creating_ssl_certificates.html" class="sidebar-link">Creating SSL Certificates</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Guides</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/guides/mounts.html" class="sidebar-link">Using Mounts</a></li></ul></div></li><li><div class="sidebar-group collapsable"><p class="sidebar-heading"><span>Development &amp; Ops</span> <span class="arrow right"></span> <!----></p> <!----></div></li></ul> </div> <div class="page"> <div class="content content__default"><h1 id="upgrading"><a href="#upgrading" class="header-anchor">#</a> Upgrading</h1> <p>Upgrading the Panel is a relatively simple process. Below you will find a list of articles that will walk you through
the upgrade process for each version of the software.</p> <h2 id="maintenance-mode"><a href="#maintenance-mode" class="header-anchor">#</a> Maintenance Mode</h2> <p>Whenever you are performing an upgrade you should be sure to place your Panel into maintenance mode. This will prevent
users from encountering unexpected errors and ensure everything can be upgraded before users encounter
potentially new features.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token comment"># Put the Panel into maintenance mode and deny user access</span>
php artisan down
<span class="token comment"># Bring the Panel back up to receive connections.</span>
php artisan up
</code></pre></div><h2 id="restarting-queue-workers"><a href="#restarting-queue-workers" class="header-anchor">#</a> Restarting Queue Workers</h2> <p>After <em>every</em> update you should restart the queue worker to ensure that the new code is loaded in and used.</p> <div class="language-bash extra-class"><pre class="language-bash"><code>php artisan queue:restart
</code></pre></div><h2 id="version-specific-guides"><a href="#version-specific-guides" class="header-anchor">#</a> Version Specific Guides</h2> <ul><li><a href="/panel/1.0/upgrade/0.7_to_1.0.html">Upgrading from 0.7.X</a></li> <li><a href="/panel/1.0/upgrade/1.0.html">1.X.X series</a></li></ul></div> <div class="page-edit"><div class="edit-link"><a href="https://github.com/pterodactyl/documentation/edit/master/panel/1.0/upgrading.md" target="_blank" rel="noopener noreferrer">Help us improve this page.</a> <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></div> <!----></div> <!----> </div></div><div class="global-ui"></div></div>
<script src="/assets/js/app.efb94fbf.js" defer></script><script src="/assets/js/4.e413141f.js" defer></script><script src="/assets/js/1.ee4ff4e2.js" defer></script><script src="/assets/js/70.8dd44fe5.js" defer></script>
</body>
</html>