Skip to main content

Migrate from Jexactyl v3

This guide is for migrating from Jexactyl v3 -> Jexpanel v4.x.

danger

These instructions are ONLY for people moving from Jexactyl v3 -> Jexpanel 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/jexactyl/artisan down

Download and extract update​

cd /var/www/jexactyl
# 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​

# Delete old vendor files
rm app/Console/Commands/Environment/EmailSettingsCommand.php

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

Backup Jexactyl database​

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

Then, once this is complete, we can then migrate the new database changes.

Migrate database changes​

php artisan migrate --seed --force

Set webserver permissions​

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

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.