Update & Upgrade

Panel dan Wings sebaiknya di-update rutin untuk fix bug & patch security.

Cek versi terpasang

Panel:

cd /var/www/pterodactyl
php artisan --version

Wings (di node):

wings --version

Cek versi terbaru di GitHub Releases.

Update Panel

1. Enable maintenance mode

cd /var/www/pterodactyl
php artisan down

Panel akan tampil "under maintenance" ke user.

2. Backup dulu

/usr/local/bin/backup-panel.sh

3. Download versi baru

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

4. Install dependency

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

5. Clear cache

php artisan view:clear
php artisan config:clear

6. Migrasi database

php artisan migrate --seed --force

7. Set permission

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

8. Restart queue

php artisan queue:restart

9. Exit maintenance

php artisan up

Update Wings

Di setiap node:

systemctl stop wings

curl -L -o /usr/local/bin/wings \
  "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"

chmod u+x /usr/local/bin/wings

systemctl start wings

Cek log setelah start:

journalctl -u wings -f

Update system OS

Rutin sebulan sekali:

apt update && apt upgrade -y
apt autoremove -y

Kalau ada kernel update, reboot terjadwal (misal jam 4 pagi, di luar jam sibuk).

Rollback

Kalau update panel gagal, restore dari backup:

# Restore database
gunzip < /var/backups/aryapanel/panel-db-LATEST.sql.gz | mysql -u root panel

# Restore file (khusus versi lama)
tar -xzf /var/backups/aryapanel/panel-files-LATEST.tar.gz -C /

# Restart
systemctl restart php8.3-fpm nginx pteroq

Breaking changes

Setiap release notes di GitHub sebutkan breaking changes. Baca dulu sebelum update major version. Contoh yang pernah terjadi:

• v1.0 → v1.11: perubahan struktur .env
• PHP requirement bump (7.4 → 8.0 → 8.1 → 8.3)
• Node.js requirement untuk build assets

Update egg dari komunitas

Egg community update terpisah dari panel. Update manual:

Admin → Nests → pilih egg → Export dulu (backup), lalu Import Egg versi baru dari parkervcp/eggs.

Server yang sudah pakai egg lama tidak otomatis update. Reinstall server yang perlu.