mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-10 10:44:43 -06:00
99 lines
27 KiB
HTML
99 lines
27 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>Legacy Upgrades | Pterodactyl</title>
|
|
<meta name="generator" content="VuePress 1.9.10">
|
|
<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/site.webmanifest">
|
|
<link rel="shortcut icon" href="/favicons/favicon.ico">
|
|
<meta name="description" content="Pterodactyl is an open-source game server management panel built with PHP, React, and Go. Designed with security in mind, Pterodactyl runs all game servers in isolated Docker containers while exposing a beautiful and intuitive UI to end users.">
|
|
<meta name="msapplication-config" content="/favicons/browserconfig.xml">
|
|
<meta name="theme-color" content="#0e4688">
|
|
|
|
<link rel="preload" href="/assets/css/0.styles.894cd3e9.css" as="style"><link rel="preload" href="/assets/js/app.5b33328c.js" as="script"><link rel="preload" href="/assets/js/4.1c05de3a.js" as="script"><link rel="preload" href="/assets/js/2.638bc23b.js" as="script"><link rel="preload" href="/assets/js/61.d30789b5.js" as="script"><link rel="prefetch" href="/assets/js/1.364681bc.js"><link rel="prefetch" href="/assets/js/10.85ddee89.js"><link rel="prefetch" href="/assets/js/11.e264572d.js"><link rel="prefetch" href="/assets/js/12.a4261b01.js"><link rel="prefetch" href="/assets/js/13.43a16fbd.js"><link rel="prefetch" href="/assets/js/14.ed610c4a.js"><link rel="prefetch" href="/assets/js/15.954755fc.js"><link rel="prefetch" href="/assets/js/16.80d778f6.js"><link rel="prefetch" href="/assets/js/17.aa66495a.js"><link rel="prefetch" href="/assets/js/18.57b733fd.js"><link rel="prefetch" href="/assets/js/19.ec92bd63.js"><link rel="prefetch" href="/assets/js/20.93f220a6.js"><link rel="prefetch" href="/assets/js/21.d99db7fa.js"><link rel="prefetch" href="/assets/js/22.c4d3c3e7.js"><link rel="prefetch" href="/assets/js/23.4a3e5e0b.js"><link rel="prefetch" href="/assets/js/24.14d17171.js"><link rel="prefetch" href="/assets/js/25.b2ca157b.js"><link rel="prefetch" href="/assets/js/26.55d35d4f.js"><link rel="prefetch" href="/assets/js/27.005f34ff.js"><link rel="prefetch" href="/assets/js/28.a5eb93d2.js"><link rel="prefetch" href="/assets/js/29.173d87c8.js"><link rel="prefetch" href="/assets/js/30.a5e153c0.js"><link rel="prefetch" href="/assets/js/31.bbfc69d7.js"><link rel="prefetch" href="/assets/js/32.f259a483.js"><link rel="prefetch" href="/assets/js/33.27c2a6a4.js"><link rel="prefetch" href="/assets/js/34.e93e5695.js"><link rel="prefetch" href="/assets/js/35.a04be06d.js"><link rel="prefetch" href="/assets/js/36.d63650be.js"><link rel="prefetch" href="/assets/js/37.25a34a1f.js"><link rel="prefetch" href="/assets/js/38.059a51d4.js"><link rel="prefetch" href="/assets/js/39.942d570b.js"><link rel="prefetch" href="/assets/js/40.26972213.js"><link rel="prefetch" href="/assets/js/41.368a213d.js"><link rel="prefetch" href="/assets/js/42.ea03a576.js"><link rel="prefetch" href="/assets/js/43.c024e279.js"><link rel="prefetch" href="/assets/js/44.4b352263.js"><link rel="prefetch" href="/assets/js/45.638b4daf.js"><link rel="prefetch" href="/assets/js/46.b6984e9b.js"><link rel="prefetch" href="/assets/js/47.0f24220f.js"><link rel="prefetch" href="/assets/js/48.c19ab66e.js"><link rel="prefetch" href="/assets/js/49.32b7f82e.js"><link rel="prefetch" href="/assets/js/5.8c798c34.js"><link rel="prefetch" href="/assets/js/50.ee14ad41.js"><link rel="prefetch" href="/assets/js/51.f11b077a.js"><link rel="prefetch" href="/assets/js/52.8e320849.js"><link rel="prefetch" href="/assets/js/53.944dc699.js"><link rel="prefetch" href="/assets/js/54.d6bff428.js"><link rel="prefetch" href="/assets/js/55.a226dbb6.js"><link rel="prefetch" href="/assets/js/56.f682278e.js"><link rel="prefetch" href="/assets/js/57.0ae7168d.js"><link rel="prefetch" href="/assets/js/58.659e70d5.js"><link rel="prefetch" href="/assets/js/59.74ce363c.js"><link rel="prefetch" href="/assets/js/6.cd87a2b3.js"><link rel="prefetch" href="/assets/js/60.ef3d5ede.js"><link rel="prefetch" href="/assets/js/62.5f19d6a7.js"><link rel="prefetch" href="/assets/js/63.38756aa5.js"><link rel="prefetch" href="/assets/js/64.ec49abec.js"><link rel="prefetch" href="/assets/js/65.61c0bfd2.js"><link rel="prefetch" href="/assets/js/66.9a2707a1.js"><link rel="prefetch" href="/assets/js/67.275f5b02.js"><link rel="prefetch" href="/assets/js/68.66b31eec.js"><link rel="prefetch" href="/assets/js/69.e57354fd.js"><link rel="prefetch" href="/assets/js/7.f17059bf.js"><link rel="prefetch" href="/assets/js/70.cbd191fe.js"><link rel="prefetch" href="/assets/js/71.e6dd244d.js"><link rel="prefetch" href="/assets/js/8.758e7e8b.js"><link rel="prefetch" href="/assets/js/9.90f962cd.js">
|
|
<link rel="stylesheet" href="/assets/css/0.styles.894cd3e9.css">
|
|
</head>
|
|
<body>
|
|
<div id="app" data-server-rendered="true"><div><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="/logos/pterry.svg" 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://discord.gg/pterodactyl" target="_blank" rel="noopener noreferrer" class="nav-link external">
|
|
Get Help
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></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
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></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://discord.gg/pterodactyl" target="_blank" rel="noopener noreferrer" class="nav-link external">
|
|
Get Help
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></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
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></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.11
|
|
<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.11
|
|
<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/additional_configuration.html" class="sidebar-link">Additional Configuration</a></li><li><a href="/panel/1.0/updating.html" class="sidebar-link">Updating the Panel</a></li><li><a href="/panel/1.0/troubleshooting.html" class="sidebar-link">Troubleshooting</a></li><li><a href="/panel/1.0/legacy_upgrade.html" aria-current="page" class="active sidebar-link">Legacy Upgrades</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#enter-maintenance-mode" class="sidebar-link">Enter Maintenance Mode</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#update-dependencies" class="sidebar-link">Update Dependencies</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#fetch-updated-files" class="sidebar-link">Fetch Updated Files</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#update-dependencies-2" class="sidebar-link">Update Dependencies</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#clear-compiled-template-cache" class="sidebar-link">Clear Compiled Template Cache</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#database-updates" class="sidebar-link">Database Updates</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#set-permissions" class="sidebar-link">Set Permissions</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#restarting-queue-workers" class="sidebar-link">Restarting Queue Workers</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#exit-maintenance-mode" class="sidebar-link">Exit Maintenance Mode</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/legacy_upgrade.html#switch-to-wings" class="sidebar-link">Switch to Wings</a></li></ul></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.11
|
|
<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.11
|
|
<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>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></ul> </div> <div class="page"> <div class="content content__default"><h1 id="legacy-upgrades"><a href="#legacy-upgrades" class="header-anchor">#</a> Legacy Upgrades</h1> <p>This upgrade guide is for <strong>upgrading from 0.7.X to 1.3.x</strong>. If you are trying to do an upgrade on a 1.X Panel
|
|
please <a href="/panel/1.0/updating.html">use this guide instead</a>. During this upgrade process you will have some periods
|
|
of Panel unavailability, however none of the underlying game server instances will be stopped.</p> <h2 id="enter-maintenance-mode"><a href="#enter-maintenance-mode" class="header-anchor">#</a> Enter Maintenance Mode</h2> <p>You'll want to put your Panel into maintenance mode by running the <code>down</code> command below before starting. This
|
|
will prevent users from accessing the Panel during a period where things will be broken or not working correctly. Make sure that you're in the <code>/var/www/pterodactyl</code> directory when executing the command.</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
|
|
</code></pre></div><h2 id="update-dependencies"><a href="#update-dependencies" class="header-anchor">#</a> Update Dependencies</h2> <p>You'll need to make sure your system dependencies are up to date before performing this upgrade. Please
|
|
reference the list below to ensure you have all of the required versions.</p> <ul><li>PHP <code>8.0</code> or <code>8.1</code> (recommended) with the following extensions: <code>cli</code>, <code>openssl</code>, <code>gd</code>, <code>mysql</code>, <code>PDO</code>, <code>mbstring</code>,
|
|
<code>tokenizer</code>, <code>bcmath</code>, <code>xml</code> or <code>dom</code>, <code>curl</code>, <code>zip</code>, and <code>fpm</code> if you are planning to use nginx. See our guide
|
|
for <a href="/guides/php_upgrade.html">Upgrading PHP</a> for details.</li> <li>Composer v2 (<code>composer self-update --2</code>)</li></ul> <div class="custom-block warning"><p class="custom-block-title">Nginx</p> <p>If you upgrade your PHP version and are using nginx as your webserver, you will have to update the
|
|
<code>fastcgi_pass</code> value in your nginx's <code>pterodactyl.conf</code> configuration to use the correct <code>php-fpm</code> socket.</p></div> <ul><li>MySQL <code>5.7.22</code> or higher (MySQL <code>8</code> recommended) <strong>or</strong> MariaDB <code>10.2</code> or higher.</li></ul> <div class="custom-block warning"><p class="custom-block-title">Seriously, Double Check your Database Version</p> <p>Please make sure you are running the correct version of MariaDB or MySQL listed above! Failure to do so <em>will</em>
|
|
result in an error when you attempt to run the migrations.</p> <p>Previous documentation (and just the age of this software) likely had you installing MariaDB 10.1 which <em>will not
|
|
work</em> with this version of Pterodactyl.</p></div> <h2 id="fetch-updated-files"><a href="#fetch-updated-files" class="header-anchor">#</a> Fetch Updated Files</h2> <p>The first step in the update process is to download the new panel files from GitHub. The command below will download
|
|
the release archive for the most recent version of Pterodactyl and save it in the current directory. Now is a good time
|
|
to ensure that you're in the <code>/var/www/pterodactyl</code> directory as the command below will automatically unpack the archive
|
|
into your current folder.</p> <p>We will also be deleting the <code>app/</code> directory. Because of the way we handle installations and upgrades deleted files
|
|
are not always detected properly, so simply uppacking over this location will result in some confusing behavior.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token comment"># Delete the app directory to ensure we start with a clean slate here. This will not affect any</span>
|
|
<span class="token comment"># of your settings or servers.</span>
|
|
<span class="token function">curl</span> <span class="token parameter variable">-L</span> <span class="token parameter variable">-o</span> panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
|
|
<span class="token function">rm</span> <span class="token parameter variable">-rf</span> <span class="token variable"><span class="token variable">$(</span><span class="token function">find</span> app public resources <span class="token parameter variable">-depth</span> <span class="token operator">|</span> <span class="token function">head</span> <span class="token parameter variable">-n</span> <span class="token parameter variable">-1</span> <span class="token operator">|</span> <span class="token function">grep</span> <span class="token parameter variable">-Fv</span> <span class="token string">"<span class="token variable"><span class="token variable">$(</span><span class="token function">tar</span> <span class="token parameter variable">-tf</span> panel.tar.gz<span class="token variable">)</span></span>"</span><span class="token variable">)</span></span>
|
|
|
|
<span class="token comment"># Download the updated files and delete the archive file.</span>
|
|
<span class="token function">tar</span> <span class="token parameter variable">-xzvf</span> panel.tar.gz <span class="token operator">&&</span> <span class="token function">rm</span> <span class="token parameter variable">-f</span> panel.tar.gz
|
|
</code></pre></div><p>Once all of the files are downloaded we need to set the correct permissions on the cache and storage directories to avoid
|
|
any webserver related errors.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">chmod</span> <span class="token parameter variable">-R</span> <span class="token number">755</span> storage/* bootstrap/cache
|
|
</code></pre></div><h2 id="update-dependencies-2"><a href="#update-dependencies-2" class="header-anchor">#</a> Update Dependencies</h2> <p>After you've downloaded all of the new files you will need to upgrade the core components of the panel. To do this,
|
|
simply run the commands below and follow any prompts.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">composer</span> <span class="token function">install</span> --no-dev --optimize-autoloader
|
|
</code></pre></div><h2 id="clear-compiled-template-cache"><a href="#clear-compiled-template-cache" class="header-anchor">#</a> Clear Compiled Template Cache</h2> <p>You'll also want to clear the compiled template cache to ensure that new and modified templates show up correctly for
|
|
users.</p> <div class="language-bash extra-class"><pre class="language-bash"><code>php artisan view:clear
|
|
php artisan config:clear
|
|
</code></pre></div><h2 id="database-updates"><a href="#database-updates" class="header-anchor">#</a> Database Updates</h2> <p>You'll also need to update your database schema for the newest version of Pterodactyl. Running the two commands below
|
|
will update the schema and ensure the default eggs we ship are up to date (and add any new ones we might have). Just
|
|
remember, <em>never edit core eggs we ship</em>! They will be overwritten by this update process.</p> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>If you used a custom plugin that allowed for server transfers on <code>0.7</code> you <strong>MUST</strong> delete or rename the <code>server_transfers</code> table
|
|
before continuing.</p></div> <div class="language-bash extra-class"><pre class="language-bash"><code>php artisan migrate <span class="token parameter variable">--force</span>
|
|
php artisan db:seed <span class="token parameter variable">--force</span>
|
|
</code></pre></div><h2 id="set-permissions"><a href="#set-permissions" class="header-anchor">#</a> Set Permissions</h2> <p>The last step is to set the proper owner of the files to be the user that runs your webserver. In most cases this
|
|
is <code>www-data</code> but can vary from system to system — sometimes being <code>nginx</code>, <code>apache</code>, or even <code>nobody</code>.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token comment"># If using NGINX or Apache (not on CentOS):</span>
|
|
<span class="token function">chown</span> <span class="token parameter variable">-R</span> www-data:www-data *
|
|
|
|
<span class="token comment"># If using NGINX on CentOS:</span>
|
|
<span class="token function">chown</span> <span class="token parameter variable">-R</span> nginx:nginx *
|
|
|
|
<span class="token comment"># If using Apache on CentOS</span>
|
|
<span class="token function">chown</span> <span class="token parameter variable">-R</span> apache:apache *
|
|
</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="exit-maintenance-mode"><a href="#exit-maintenance-mode" class="header-anchor">#</a> Exit Maintenance Mode</h2> <p>Now that the upgrade is complete, exit maintenance mode and your Panel will now be available.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token comment"># Bring the Panel back up to receive connections.</span>
|
|
php artisan up
|
|
</code></pre></div><h2 id="switch-to-wings"><a href="#switch-to-wings" class="header-anchor">#</a> Switch to Wings</h2> <p>We've deprecated the old Node.js daemon in favor of <a href="https://github.com/pterodactyl/wings" target="_blank" rel="noopener noreferrer">Wings<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></a>, our new server
|
|
control plane written in Go. This new system is significantly faster, easier to install, and much smaller. All you
|
|
need to do is install a single binary on your system and configure it to run on boot. <strong>You cannot use the old Node.js
|
|
Daemon to run servers with Pterodactyl Panel 1.0.</strong></p> <p>Please see <a href="/wings/1.0/migrating.html">Migrating to Wings</a> for instructions.</p></div> <div class="page-edit"><div class="edit-link"><a href="https://github.com/pterodactyl/documentation/edit/master/panel/1.0/legacy_upgrade.md" target="_blank" rel="noopener noreferrer">Help us improve this page.</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></div> <!----></div> <!----> </div></div></div><div class="global-ui"></div></div>
|
|
<script src="/assets/js/app.5b33328c.js" defer></script><script src="/assets/js/4.1c05de3a.js" defer></script><script src="/assets/js/2.638bc23b.js" defer></script><script src="/assets/js/61.d30789b5.js" defer></script>
|
|
</body>
|
|
</html>
|