Installation

Configure the Application

Configure Southactyl environment settings and install Composer dependencies.

Configure the application

Copy the environment file

Terminal
cd /var/www/southactyl
cp .env.example .env

Install PHP dependencies

Terminal
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader

Generate the application key

Terminal
php artisan key:generate --force

Back up the application key

Print the key:

Terminal
grep APP_KEY /var/www/southactyl/.env

Save the full APP_KEY=base64:... line somewhere secure, such as a password manager.

Critical: If you lose the APP_KEY, encrypted data such as API keys cannot be recovered. A database backup without the matching APP_KEY may be useless.

Run environment setup

Terminal
php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail

Recommended values:

PromptRecommended value
Application URLhttps://panel.example.com
Cache driverredis
Session driverredis
Queue driverredis
Database host127.0.0.1
Database namesouthactyl
Database usernamesouthactyl
Database passwordYour database password

If Southactyl renamed the artisan commands, use the Southactyl equivalents.

Optional: disable inherited Pterodactyl telemetry

If Southactyl still includes Pterodactyl telemetry and you do not want it enabled, add or update this in .env:

.env
PTERODACTYL_TELEMETRY_ENABLED=false

Then clear the config cache:

Terminal
php artisan config:clear
php artisan cache:clear

If Southactyl removed or renamed telemetry, ignore this section.

Copyright © 2026