Additional Configuration

Additional Configurations and settings for Hydrodactyl

Backups

Hydrodactyl Panel allows users to create backups of their servers. In order to create backups, a backup storage method has to be configured.

When changing Hydrodactyl Panel's backup storage method, users may still download or delete existing backups from the prior storage driver. In the instance of migrating from S3 to local backups, S3 credentials must remain configured after switching to the local backup storage method.

Local Backups

By default, Hydrodactyl Panel uses local storage for backups. This is a per-server configured value that you will have to edit when setting up the node.

Captcha

Much like backups. The Captcha system has had a very large rehaul. Instead of only supporting Recaptcha, we support 3 major ones(for now).

  • Cloudflare Turnstile
  • Hcaptcha
  • Recaptcha v3

To configure these, it is no longer done through environment variables. Instead, visit your admin panel at
https://your-panel.dev/admin/settings/captcha
The setup is very self explanetory and as such, no details will be provided here. If you need help, visit the discord.

Disabling Captcha

If you get locked out of your panel by a failing captcha challenge, be it a broken key, or expired key. You can stop Captcha from being shown and used by just adding this to your environment.

USE_CAPTCHA=false

Additional

2FA

Two Factor Authentication is paramount in securing your application from bad actors. Hydrodactyl(currently) uses the very same system as Pterodactyl. Using any 2fa app you can scann or input your code and it will generate a random 6 digit number every 60 seconds. When you are loggin in this will be asked for after you enter your password.

Disable 2FA requirement

If you are locked out of your 2fa(lost it or some other way) you can stop the requirement with a simple database edit

# If using MariaDB (v11.0.0+)
mariadb -u root -p

# If using MySQL
mysql -u root -p
UPDATE panel.settings SET value = 0 WHERE `key` = 'settings::pterodactyl:auth:2fa_required';

Disable 2FA for a specific user

Run the following command in your /var/www/hydrodactyl directory.

php artisan p:user:disable2fa