Legacy Upgrades

This upgrade guide is for upgrading from 0.7.X to 1.3.x. If you are trying to do an upgrade on a 1.X Panel please use this guide instead. During this upgrade process you will have some periods of Panel unavailability, however none of the underlying game server instances will be stopped.

Enter Maintenance Mode

Put your Panel into maintenance mode by running the `down` command below. This will prevent users from accessing the Panel during the upgrade process.

# Put the Panel into maintenance mode and deny user access
php artisan down

Fetch Updated Files

Download the new panel files from GitHub and set the correct permissions.

# Download and extract the latest panel files
curl -L -o panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
rm -rf $(find app public resources -depth | head -n -1 | grep -Fv "$(tar -tf panel.tar.gz)")
tar -xzvf panel.tar.gz && rm -f panel.tar.gz

# Set correct permissions
chmod -R 755 storage/* bootstrap/cache

Update Dependencies

Upgrade the core components of the panel.

composer install --no-dev --optimize-autoloader

Clear Compiled Template Cache

Clear the compiled template cache to ensure that new and modified templates show up correctly.

php artisan view:clear
php artisan config:clear

Database Updates

Update your database schema for the newest version of Pterodactyl.

Warning

If you used a custom plugin that allowed for server transfers on `0.7` you MUST delete or rename the `server_transfers` table before continuing.

php artisan migrate --force
php artisan db:seed --force

Set Permissions

Set the proper owner of the files to be the user that runs your webserver.

# If using NGINX or Apache (not on CentOS):
chown -R www-data:www-data *

# If using NGINX on CentOS:
chown -R nginx:nginx *

# If using Apache on CentOS
chown -R apache:apache *

Exit Maintenance Mode

Exit maintenance mode to make your Panel available again.

# Bring the Panel back up to receive connections.
php artisan up