Updating the Panel
Safely update the Skyport panel to a new version.
Before updating, read the release notes for the version you are moving to.
1. Back up your data
Section titled “1. Back up your data”At minimum, back up:
- Your database (SQLite file or MySQL dump)
.env- Any custom Nginx or service files
2. Enter maintenance mode
Section titled “2. Enter maintenance mode”cd /var/www/skyportphp artisan down3. Pull the new code
Section titled “3. Pull the new code”git fetch --all --tagsgit pull --ff-only4. Update dependencies and rebuild
Section titled “4. Update dependencies and rebuild”COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloaderbun installbun run build:ssr5. Run database migrations
Section titled “5. Run database migrations”php artisan migrate --force6. Regenerate routes
Section titled “6. Regenerate routes”php artisan wayfinder:generate --with-form --no-interaction7. Clear caches
Section titled “7. Clear caches”php artisan optimize:clear8. Restart services
Section titled “8. Restart services”sudo systemctl restart skyport-panel skyport-queue skyport-ssr9. Exit maintenance mode
Section titled “9. Exit maintenance mode”php artisan upAlso update your daemons
Section titled “Also update your daemons”Keep skyportd close to the panel version. The daemon performs compatibility checks, so mismatched versions may cause enrollment or sync failures.
See Upgrading skyportd.