Skip to main content

Manual Upgrade (v4.x -> v4.x)

This guide is for upgrading the Panel to a new version.

danger

This will NOT work if you are trying to migrate from Pterodactyl, or Jexactyl v3.x. This is only for people currently running version 4 to upgrade to a new release.

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/archive/refs/tags/v4.0.0-rc3.tar.gz

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

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

Update dependencies​

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

Clear backend cache (optional)​

php artisan optimize:clear

Migrate database changes​

php artisan migrate --seed --force

Set webserver permissions​

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

# If using NGINX on CentOS
chown -R nginx:nginx /var/www/jexactyl/*

# If using Apache on CentOS
chown -R apache:apache /var/www/jexactyl/*

Exit maintenance mode​

php artisan up
success

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