Sauvegardez la machine avant de commencer. Ce guide concerne le Panel ; l'installation de Wings sur les nœuds de jeu est une étape distincte.
1. Prérequis
Utilisez Ubuntu 24.04 avec un accès root, un nom de domaine dirigé vers le serveur et les ports HTTP/HTTPS ouverts. Pterodactyl nécessite PHP 8.2 ou 8.3, MariaDB/MySQL, Redis, un serveur web et Composer 2.
2. Installer les dépendances
apt update
apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server curl
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
3. Télécharger le panel
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/
4. Préparer MariaDB
Choisissez un mot de passe unique et remplacez VOTRE_MOT_DE_PASSE.
mariadb -u root -p
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'VOTRE_MOT_DE_PASSE';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit
5. Configurer Pterodactyl
cd /var/www/pterodactyl
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan key:generate --force
php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail
php artisan migrate --seed --force
php artisan p:user:make
chown -R www-data:www-data /var/www/pterodactyl/*
Conservez une copie sécurisée de la valeur APP_KEY. Sans elle, les données chiffrées du panel ne pourront pas être récupérées.
6. Activer les tâches et le worker
Ajoutez au crontab root :
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
Créez ensuite /etc/systemd/system/pteroq.service :
[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service
[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
RestartSec=5s
[Install]
WantedBy=multi-user.target
systemctl enable --now redis-server
systemctl enable --now pteroq.service
7. Configurer Nginx et HTTPS
Terminez avec la configuration Nginx et un certificat TLS adaptés à votre domaine. N'utilisez pas la configuration SSL officielle avant que le certificat existe, sinon Nginx refusera de démarrer.
Source : documentation officielle Pterodactyl ↗