mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-10 10:44:43 -06:00
103 lines
25 KiB
HTML
103 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.8.2">
|
|
<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 7, 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.b3d0dfa6.css" as="style"><link rel="preload" href="/assets/js/app.6ca2c4a6.js" as="script"><link rel="preload" href="/assets/js/4.babf7215.js" as="script"><link rel="preload" href="/assets/js/1.79a56ae5.js" as="script"><link rel="preload" href="/assets/js/70.51c1e550.js" as="script"><link rel="prefetch" href="/assets/js/10.27cec751.js"><link rel="prefetch" href="/assets/js/11.27ba30b0.js"><link rel="prefetch" href="/assets/js/12.2e01246c.js"><link rel="prefetch" href="/assets/js/13.bd04c4ec.js"><link rel="prefetch" href="/assets/js/14.f2be742e.js"><link rel="prefetch" href="/assets/js/15.a6802091.js"><link rel="prefetch" href="/assets/js/16.f2dea920.js"><link rel="prefetch" href="/assets/js/17.e3b378b0.js"><link rel="prefetch" href="/assets/js/18.fcb158a9.js"><link rel="prefetch" href="/assets/js/19.f0fdb6e9.js"><link rel="prefetch" href="/assets/js/2.21e1a937.js"><link rel="prefetch" href="/assets/js/20.a31cd600.js"><link rel="prefetch" href="/assets/js/21.986dab58.js"><link rel="prefetch" href="/assets/js/22.01e99816.js"><link rel="prefetch" href="/assets/js/23.ab477db3.js"><link rel="prefetch" href="/assets/js/24.3db401dc.js"><link rel="prefetch" href="/assets/js/25.fb19183c.js"><link rel="prefetch" href="/assets/js/26.199e42e5.js"><link rel="prefetch" href="/assets/js/27.53b2955f.js"><link rel="prefetch" href="/assets/js/28.b1cca863.js"><link rel="prefetch" href="/assets/js/29.c234f3e0.js"><link rel="prefetch" href="/assets/js/30.61a90133.js"><link rel="prefetch" href="/assets/js/31.6cbb938e.js"><link rel="prefetch" href="/assets/js/32.7effab83.js"><link rel="prefetch" href="/assets/js/33.5cb72a20.js"><link rel="prefetch" href="/assets/js/34.f044669f.js"><link rel="prefetch" href="/assets/js/35.cf289140.js"><link rel="prefetch" href="/assets/js/36.a7402f3b.js"><link rel="prefetch" href="/assets/js/37.b81f7a4e.js"><link rel="prefetch" href="/assets/js/38.e385c788.js"><link rel="prefetch" href="/assets/js/39.a7036ff5.js"><link rel="prefetch" href="/assets/js/40.5561e292.js"><link rel="prefetch" href="/assets/js/41.8357cc2d.js"><link rel="prefetch" href="/assets/js/42.ed9e1c27.js"><link rel="prefetch" href="/assets/js/43.9fd714d5.js"><link rel="prefetch" href="/assets/js/44.5250ac95.js"><link rel="prefetch" href="/assets/js/45.3ebbab0e.js"><link rel="prefetch" href="/assets/js/46.a3168226.js"><link rel="prefetch" href="/assets/js/47.7a0c0c49.js"><link rel="prefetch" href="/assets/js/48.8b4df094.js"><link rel="prefetch" href="/assets/js/49.1e699f40.js"><link rel="prefetch" href="/assets/js/5.407df260.js"><link rel="prefetch" href="/assets/js/50.fb545b0b.js"><link rel="prefetch" href="/assets/js/51.8bf819d3.js"><link rel="prefetch" href="/assets/js/52.c0fa38e2.js"><link rel="prefetch" href="/assets/js/53.acaa8c4b.js"><link rel="prefetch" href="/assets/js/54.01f718b6.js"><link rel="prefetch" href="/assets/js/55.0c83194a.js"><link rel="prefetch" href="/assets/js/56.488f03fe.js"><link rel="prefetch" href="/assets/js/57.6cdf7d48.js"><link rel="prefetch" href="/assets/js/58.139108d1.js"><link rel="prefetch" href="/assets/js/59.2de63e9e.js"><link rel="prefetch" href="/assets/js/6.8999fd8a.js"><link rel="prefetch" href="/assets/js/60.a35a1994.js"><link rel="prefetch" href="/assets/js/61.c644eb6e.js"><link rel="prefetch" href="/assets/js/62.6d624b0b.js"><link rel="prefetch" href="/assets/js/63.08f06847.js"><link rel="prefetch" href="/assets/js/64.8d69a757.js"><link rel="prefetch" href="/assets/js/65.81003f00.js"><link rel="prefetch" href="/assets/js/66.2ff8637d.js"><link rel="prefetch" href="/assets/js/67.c7e98a1e.js"><link rel="prefetch" href="/assets/js/68.e7498700.js"><link rel="prefetch" href="/assets/js/69.bb730956.js"><link rel="prefetch" href="/assets/js/7.9f1ce256.js"><link rel="prefetch" href="/assets/js/71.91217b54.js"><link rel="prefetch" href="/assets/js/72.7f5dd9c7.js"><link rel="prefetch" href="/assets/js/73.3c0e5aad.js"><link rel="prefetch" href="/assets/js/74.1351a3ef.js"><link rel="prefetch" href="/assets/js/75.6351ca99.js"><link rel="prefetch" href="/assets/js/76.0b5f8895.js"><link rel="prefetch" href="/assets/js/77.54ccbb7a.js"><link rel="prefetch" href="/assets/js/78.8283cd45.js"><link rel="prefetch" href="/assets/js/8.f62ead52.js"><link rel="prefetch" href="/assets/js/9.7af626f7.js">
|
|
<link rel="stylesheet" href="/assets/css/0.styles.b3d0dfa6.css">
|
|
</head>
|
|
<body>
|
|
<div id="app" data-server-rendered="true"><div><div class="fixed h-12 w-full z-50 top-0"><div class="h-12 w-full bg-black flex items-center justify-center px-4"><p class="text-grey-lightest font-semibold">
|
|
Stand with Ukraine 🇺🇦
|
|
<a href="https://www.savethechildren.org/us/where-we-work/ukraine" target="_blank" rel="noindex nofollow noopener" class="text-blue-lighter">Donate</a> <a href="https://razomforukraine.org/" target="_blank" rel="noindex nofollow noopener" class="text-blue-lighter">Today.</a></p></div></div> <div class="theme-container mt-12"><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.7
|
|
<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.7
|
|
<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.5
|
|
<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.5
|
|
<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><li><div class="sidebar-group collapsable"><p class="sidebar-heading"><span>Development & Ops</span> <span class="arrow right"></span> <!----></p> <!----></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><strong>1.7.x</strong></td> <td><strong>1.5.x</strong></td> <td>✅</td> <td>7.4, 8.0</td></tr></tbody></table> <h2 id="update-dependencies"><a href="#update-dependencies" class="header-anchor">#</a> Update Dependencies</h2> <div class="custom-block warning"><p class="custom-block-title">Minimum PHP Version Changed</p> <p>If you are upgrading from a version of Pterodactyl <em>prior to</em> <code>1.3.x</code> you'll need to update your PHP
|
|
dependencies. The latest versions of Pterodactyl Panel require a <strong>minimum version of PHP 7.4</strong> and
|
|
Composer v2.</p></div> <ul><li>PHP <code>7.4</code> or <code>8.0</code> (recommended)</li> <li>Composer <code>2.X</code></li></ul> <p>Previous versions of Pterodactyl allowed for you to be running PHP 7.3. However, due to dependency updates and
|
|
the fact that 7.3 is now EOL we have bumped the minimum acceptable PHP version to 7.4 — PHP 8 is recommended. You
|
|
will also need to be using Composer v2.</p> <p><strong>Before continuing</strong>, please ensure that your system and web server configuration has been upgraded to at least PHP 7.4 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 7.4 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- extra-class"><pre class="language-text"><code>vagrant@pterodactyl:~/app$ php -v
|
|
PHP 8.0.1 (cli) (built: Jan 13 2021 08:22:35) ( NTS )
|
|
Copyright (c) The PHP Group
|
|
Zend Engine v4.0.1, Copyright (c) Zend Technologies
|
|
with Zend OPcache v8.0.1, Copyright (c), by Zend Technologies
|
|
|
|
vagrant@pterodactyl:~/app$ composer --version
|
|
Composer version 2.0.8 2020-12-03 17:20:38
|
|
</code></pre></div><h2 id="self-upgrade"><a href="#self-upgrade" class="header-anchor">#</a> Self Upgrade</h2> <p>If your version of Pterodactyl Panel is <code>1.3.2</code> or higher, you can simply run the following command to perform a
|
|
self-upgrade of the Panel. This will download all of the necessary files and perform all of the actions listed
|
|
in this upgrade documentation.</p> <p><strong>Note:</strong> You must have <code>php-posix</code> extension for the self-upgrade to detect file ownership.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token builtin class-name">cd</span> /var/www/pterodactyl <span class="token operator">&&</span> php artisan p:upgrade
|
|
</code></pre></div><p><a href="/wings/1.0/upgrading.html">Final Step: Upgrade Wings</a></p> <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> -L https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz <span class="token operator">|</span> <span class="token function">tar</span> -xzv
|
|
</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> -R <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>composer <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 --seed --force
|
|
</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> -R www-data:www-data /var/www/pterodactyl/*
|
|
|
|
<span class="token comment"># If using NGINX on CentOS:</span>
|
|
<span class="token function">chown</span> -R nginx:nginx /var/www/pterodactyl/*
|
|
|
|
<span class="token comment"># If using Apache on CentOS</span>
|
|
<span class="token function">chown</span> -R 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><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.6ca2c4a6.js" defer></script><script src="/assets/js/4.babf7215.js" defer></script><script src="/assets/js/1.79a56ae5.js" defer></script><script src="/assets/js/70.51c1e550.js" defer></script>
|
|
</body>
|
|
</html>
|