A good start.

Before you start

Alto 1.0.0 is a native client theme for an existing, unmodified Pterodactyl Panel 1.15.1. Integration checks use Wings 1.13.3. Your PHP, database, web server, cron and queue services must already work.

• Back up the panel files and database. Keep your APP_KEY safe.
• Use Python 3.9 or newer for the installer, preferably a currently maintained release.
• Extract the buyer ZIP outside the panel directory and outside the public web root.
• Existing themes and frontend extensions are not automatically merged.

The package includes precompiled assets. You do not need to run Yarn on the production server.

Check, then install

From the extracted Alto package directory, replace the panel path below with your actual path.

python3 install.py check --panel /var/www/pterodactyl

After the check passes and your backups are ready:

sudo python3 install.py install --panel /var/www/pterodactyl

The installer backs up original files under .alto-theme/backups, enables maintenance, installs the theme and its database tables, reloads caches and reopens the panel. It verifies protected file fingerprints before applying changes.

For Docker, run the installer inside the panel’s Linux container with Python available there. If your PHP executable has a different path, add --php /usr/bin/php8.3, adjusted for your installation.

Sign in with your normal Pterodactyl account. Appearance settings live in the top menu. The original administrator area remains available.

Optional integrations

Catalogs

Modrinth and SpigotMC need internet access from your panel and Wings. For CurseForge, Hytale and Palworld, set ALTO_CURSEFORGE_KEY in the panel environment. Your authorized key determines available games and downloads.

Check game versions, loaders and dependencies before downloading. Modpack archives require separate deployment and configuration.

BlueMap

Provide your own publicly reachable HTTPS BlueMap URL. The map host must allow iframe embedding. An external-open button remains available. A labelled public example is shown until you configure your own map.

Assistant

The predefined guide works without an external provider. For OpenAI responses, set your own ALTO_AI_KEY and ALTO_AI_MODEL server-side. Provider charges are separate. Only chat messages are sent; files, logs and secrets are not automatically attached. The assistant cannot execute actions.

After changing environment variables, run php artisan config:clear and restart workers as required by your deployment.

Game workspaces

Minecraft Java player tools read saved world and usercache files. FiveM tools use server.cfg and resource folders. The common Pterodactyl tools follow your configured eggs and native permissions.

Update or uninstall

Use the installer from a compatible Alto package:

sudo python3 install.py update --panel /var/www/pterodactyl
sudo python3 install.py uninstall --panel /var/www/pterodactyl

Uninstall restores original panel files and keeps Alto preferences, conversations and encrypted secrets in the database. Modified theme files are detected and need review before replacement. Keep the stable APP_KEY needed to decrypt stored secrets.

If an operation is interrupted

Use the backup identifier printed by the installer:

sudo python3 install.py restore --panel /var/www/pterodactyl --backup BACKUP_IDENTIFIER

Recovery snapshots the current files first. If the panel was already in maintenance, check the result before running php artisan up. Keep .alto-theme until recovery and verification are complete. Full instructions are included in English and French.

About the public preview

The preview uses the compiled Alto client interface with sample records and simulated resource readings. It has no live panel credentials and cannot change files, upload data, send messages or execute server commands.

The welcome screen opens the demo without an account. A real Alto installation keeps Pterodactyl authentication. Temporary appearance changes in the preview do not affect anyone else’s installation.