documentation/panel/1.0/updating.html

97 lines
25 KiB
HTML

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Updating the Panel | 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.99d9fe83.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/63.38756aa5.js" as="script"><link rel="prefetch" href="/assets/js/1.364681bc.js"><link rel="prefetch" href="/assets/js/10.08b9c98e.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.65d10cad.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.eb49f3aa.js"><link rel="prefetch" href="/assets/js/30.9c360be1.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.8fbdd539.js"><link rel="prefetch" href="/assets/js/34.49d78ff7.js"><link rel="prefetch" href="/assets/js/35.073e41d7.js"><link rel="prefetch" href="/assets/js/36.30ac2240.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.8cadaf75.js"><link rel="prefetch" href="/assets/js/40.d5244f41.js"><link rel="prefetch" href="/assets/js/41.59ce7d2b.js"><link rel="prefetch" href="/assets/js/42.45c68365.js"><link rel="prefetch" href="/assets/js/43.9b0bb612.js"><link rel="prefetch" href="/assets/js/44.a7d15b9f.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.f62e3b58.js"><link rel="prefetch" href="/assets/js/5.8c798c34.js"><link rel="prefetch" href="/assets/js/50.0b4f4dc4.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.d70cb838.js"><link rel="prefetch" href="/assets/js/55.a226dbb6.js"><link rel="prefetch" href="/assets/js/56.ad9228bb.js"><link rel="prefetch" href="/assets/js/57.f50380a8.js"><link rel="prefetch" href="/assets/js/58.659e70d5.js"><link rel="prefetch" href="/assets/js/59.93d2ca49.js"><link rel="prefetch" href="/assets/js/6.cd87a2b3.js"><link rel="prefetch" href="/assets/js/60.61b94576.js"><link rel="prefetch" href="/assets/js/61.78ebf38b.js"><link rel="prefetch" href="/assets/js/62.5f19d6a7.js"><link rel="prefetch" href="/assets/js/64.58b54b08.js"><link rel="prefetch" href="/assets/js/65.372034bb.js"><link rel="prefetch" href="/assets/js/66.69a87c64.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.7ae04d0b.js"><link rel="prefetch" href="/assets/js/7.f17059bf.js"><link rel="prefetch" href="/assets/js/70.20bc2184.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.767b0305.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" aria-current="page" class="active sidebar-link">Updating the Panel</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/panel/1.0/updating.html#panel-version-requirements" class="sidebar-link">Panel Version Requirements</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/updating.html#update-dependencies" class="sidebar-link">Update Dependencies</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/updating.html#self-upgrade" class="sidebar-link">Self Upgrade</a></li><li class="sidebar-sub-header"><a href="/panel/1.0/updating.html#manual-upgrade" class="sidebar-link">Manual Upgrade</a></li></ul></li><li><a href="/panel/1.0/troubleshooting.html" class="sidebar-link">Troubleshooting</a></li><li><a href="/panel/1.0/legacy_upgrade.html" class="sidebar-link">Legacy Upgrades</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.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="updating-the-panel"><a href="#updating-the-panel" class="header-anchor">#</a> Updating the Panel</h1> <p>This documentation covers the process for updating within the <code>1.x</code> series of releases. This means updating from
— for example — <code>1.5.0</code> to <code>1.6.0</code>. <strong>Do not use this guide for upgrading from <code>0.7</code>.</strong></p> <h2 id="panel-version-requirements"><a href="#panel-version-requirements" class="header-anchor">#</a> Panel Version Requirements</h2> <p>Each version of Pterodactyl Panel also has a corresponding minimum version of Wings that
is required for it to run. Please see the chart below for how these versions line up. In
most cases your base Wings version should match that of your Panel.</p> <table><thead><tr><th>Panel Version</th> <th>Wings Version</th> <th>Supported</th> <th>PHP Versions</th></tr></thead> <tbody><tr><td>1.0.x</td> <td>1.0.x</td> <td></td> <td>7.3, 7.4</td></tr> <tr><td>1.1.x</td> <td>1.1.x</td> <td></td> <td>7.3, 7.4</td></tr> <tr><td>1.2.x</td> <td>1.2.x</td> <td></td> <td>7.3, 7.4</td></tr> <tr><td>1.3.x</td> <td>1.3.x</td> <td></td> <td>7.4, 8.0</td></tr> <tr><td>1.4.x</td> <td>1.4.x</td> <td></td> <td>7.4, 8.0</td></tr> <tr><td>1.5.x</td> <td>1.4.x</td> <td></td> <td>7.4, 8.0</td></tr> <tr><td>1.6.x</td> <td>1.4.x</td> <td></td> <td>7.4, 8.0</td></tr> <tr><td>1.7.x</td> <td>1.5.x</td> <td></td> <td>7.4, 8.0</td></tr> <tr><td>1.8.x</td> <td>1.6.x</td> <td></td> <td>7.4, 8.0, 8.1</td></tr> <tr><td>1.9.x</td> <td>1.6.x</td> <td></td> <td>7.4, 8.0, 8.1</td></tr> <tr><td>1.10.x</td> <td>1.7.x</td> <td></td> <td>7.4, 8.0, 8.1</td></tr> <tr><td><strong>1.11.x</strong></td> <td><strong>1.11.x</strong></td> <td></td> <td><s>8.1</s>, 8.2, <strong>8.3</strong></td></tr></tbody></table> <div class="custom-block tip"><p class="custom-block-title">Wings releases</p> <p>There are no 1.8.x, 1.9.x, or 1.10.x releases of Wings.</p></div> <h2 id="update-dependencies"><a href="#update-dependencies" class="header-anchor">#</a> Update Dependencies</h2> <ul><li>PHP <code>8.2</code>, or <code>8.3</code> (recommended)</li> <li>Composer <code>2.X</code></li></ul> <p><strong>Before continuing</strong>, please ensure that your system and web server configuration has been upgraded to at least PHP 8.2 by running <code>php -v</code> and Composer 2 by running <code>composer --version</code>. You
should see an output similar to the result below. If you do not see at least PHP 8.2 and Composer 2, you will need to upgrade by following
our <a href="/guides/php_upgrade.html">PHP Upgrade Guide</a> and return to this documentation afterward.</p> <div class="language-shell extra-class"><pre class="language-shell"><code>vagrant@pterodactyl:~/app$ php <span class="token parameter variable">-v</span>
PHP <span class="token number">8.2</span>.5 <span class="token punctuation">(</span>cli<span class="token punctuation">)</span> <span class="token punctuation">(</span>built: Dec <span class="token number">21</span> <span class="token number">2022</span> <span class="token number">10</span>:32:13<span class="token punctuation">)</span> <span class="token punctuation">(</span>NTS<span class="token punctuation">)</span>
Copyright <span class="token punctuation">(</span>c<span class="token punctuation">)</span> The PHP Group
Zend Engine v4.1.5, Copyright <span class="token punctuation">(</span>c<span class="token punctuation">)</span> Zend Technologies
with Zend OPcache v8.2.5, Copyright <span class="token punctuation">(</span>c<span class="token punctuation">)</span>, by Zend Technologies
vagrant@pterodactyl:~/app$ <span class="token function">composer</span> <span class="token parameter variable">--version</span>
Composer version <span class="token number">2.3</span>.5 <span class="token number">2022</span>-04-13 <span class="token number">16</span>:43:00
</code></pre></div><h2 id="self-upgrade"><a href="#self-upgrade" class="header-anchor">#</a> Self Upgrade</h2> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>The self-upgrade is currently in-operable due to issues with some dependencies we make use of.
For the time being please perform a manual upgrade until this issue can be resolved.</p></div> <h2 id="manual-upgrade"><a href="#manual-upgrade" class="header-anchor">#</a> Manual Upgrade</h2> <p>If you prefer not to perform the automatic self-upgrade, or need to reference any upgrade steps you can follow
the documentation below.</p> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>If you've already performed the self-upgrade successfully you do not need to do anything else on this page.</p></div> <h3 id="enter-maintenance-mode"><a href="#enter-maintenance-mode" class="header-anchor">#</a> Enter Maintenance Mode</h3> <p>Whenever you are performing an update you should be sure to place your Panel into maintenance mode. This will prevent
users from encountering unexpected errors and ensure everything can be updated before users encounter
potentially new features.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token builtin class-name">cd</span> /var/www/pterodactyl
php artisan down
</code></pre></div><h3 id="download-the-update"><a href="#download-the-update" class="header-anchor">#</a> Download the Update</h3> <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, save it in the current directory and will automatically
unpack the archive into your current folder.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-L</span> https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz <span class="token operator">|</span> <span class="token function">tar</span> <span class="token parameter variable">-xzv</span>
</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><h3 id="update-dependencies-2"><a href="#update-dependencies-2" class="header-anchor">#</a> Update Dependencies</h3> <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><h3 id="clear-compiled-template-cache"><a href="#clear-compiled-template-cache" class="header-anchor">#</a> Clear Compiled Template Cache</h3> <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><h3 id="database-updates"><a href="#database-updates" class="header-anchor">#</a> Database Updates</h3> <p>You'll also need to update your database schema for the newest version of Pterodactyl. Running the command 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="language-bash extra-class"><pre class="language-bash"><code>php artisan migrate <span class="token parameter variable">--seed</span> <span class="token parameter variable">--force</span>
</code></pre></div><h3 id="set-permissions"><a href="#set-permissions" class="header-anchor">#</a> Set Permissions</h3> <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>caddy</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 /var/www/pterodactyl/*
<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 /var/www/pterodactyl/*
<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 /var/www/pterodactyl/*
</code></pre></div><h3 id="restarting-queue-workers"><a href="#restarting-queue-workers" class="header-anchor">#</a> Restarting Queue Workers</h3> <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><h3 id="exit-maintenance-mode"><a href="#exit-maintenance-mode" class="header-anchor">#</a> Exit Maintenance Mode</h3> <p>Now that everything has been updated you need to exit maintenance mode so that the Panel can resume accepting
connections.</p> <div class="language-bash extra-class"><pre class="language-bash"><code>php artisan up
</code></pre></div><h3 id="telemetry"><a href="#telemetry" class="header-anchor">#</a> Telemetry</h3> <p>Since 1.11, Pterodactyl will collect anonymous telemetry to help us better understand how the
software is being used. To learn more about this feature and to opt-out, please see our <a href="/panel/1.0/additional_configuration.html#telemetry">Telemetry</a>
documentation. Remember to continue with the rest of the upgrade.</p> <p><a href="/wings/1.0/upgrading.html">Final Step: Upgrade Wings</a></p></div> <div class="page-edit"><div class="edit-link"><a href="https://github.com/pterodactyl/documentation/edit/master/panel/1.0/updating.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.99d9fe83.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/63.38756aa5.js" defer></script>
</body>
</html>