Updating Hydrodactyl

Panel Version Requirements

Updating Your panel

Update Dependencies

Check your current versions by running

php -v
composer --version

they should match at least the minimum version supported by the release your installing.

Self Upgrade

This is a feature in the works. It is planned for development and release at a soon point in the future.

Manual Upgrade

Enter Maintenance Mode

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.

cd /var/www/hydrodactyl

php artisan down

Set permissions

This is a temporary change to make the following setup easier. This will be changed back later! $(id -un):$(id -gn) changes the ownership of the files to your current user. You can alter this if you know what you are doing.

chown -R $(id -un):$(id -gn) /var/www/hydrodactyl/.

Download the Update

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 Hydrodactyl, save it in the current directory and will automatically unpack the archive into your current folder.

curl -L https://github.com/blueprintframework/hydrodactyl/releases/latest/download/panel.tar.gz | tar -xzv

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:

chmod -R 755 storage/* bootstrap/cache

Update Dependencies

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.

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

You must also check for updated and new pnpm dependencies. This can be done by running

pnpm i

Build New frontend assets

pnpm build

Clear Compiled Template Cache

You'll also want to clear the compiled template cache to ensure that new and modified templates show up correctly for users.

php artisan view:clear
php artisan config:clear

Database Updates

php artisan migrate --seed --force

Set Permissions

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 www-data but can vary from system to system — sometimes being nginx, caddy, apache, or even nobody.

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

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

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

Restarting Queue Workers

php artisan queue:restart

Exit Maintenance Mode

Now that everything has been updated you need to exit maintenance mode so that the Panel can resume accepting connections.

php artisan up