Migrate from Pterodactyl

This guide is for migrating from Pterodactyl v1.x -> Jexactyl v4.x.

danger

These instructions are ONLY for people moving from Pterodactyl v1.x -> Jexactyl v4.x. Check the sidebar if you wish to upgrade your existing instance or migrate your data from another panel.

Enter maintenance mode

To keep the panel's integrity, put the app into maintenance mode so no one can access it.

php /var/www/pterodactyl/artisan down

Download and extract update

cd /var/www/pterodactyl
# Download file archive from GitHub
curl -Lo panel.tar.gz https://github.com/jexactyl/jexactyl/releases/latest/download/panel.tar.gz

# Extract the archive
tar -xzvf panel.tar.gz
rm panel.tar.gz

# Give certain folders higher permissions for access
chmod -R 755 storage/* bootstrap/cache/

Update dependencies

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

Backup Pterodactyl database

# Replace 'panel' with the name of your database if needed
mysqldump panel > /var/www/pterodactyl/backup.sql

Migrate database changes

php artisan migrate --seed --force

Set webserver permissions

chown -R www-data:www-data /var/www/pteroactyl/*

Clear application cache

php artisan optimize:clear

Exit maintenance mode

php artisan up

warning

It may be that your Panel gets stuck on the 'Welcome to Jexpanel' page. If so, ensure that the variable APP_ENVIRONMENT_ONLY in your /var/www/jexactyl/.env file is set to false, and not true.

success

Jexpanel should now be installed and running on your webserver. Any issues? Let us know on our Discord.