VPS & Linux
Installer Pterodactyl sur un VPS : Panel, Wings et premiers serveurs
Pterodactyl vous donne votre propre panel de serveurs de jeux. Ce guide installe le Panel et Wings sur un même VPS Ubuntu LTS, puis crée le nœud et un premier serveur.
Ce que vous allez installer
Pterodactyl se compose de deux briques :
| Brique | Rôle | Technologies |
|---|---|---|
| Panel | Interface web : comptes, serveurs, ressources, console | PHP, MariaDB, Redis, Nginx |
| Wings | Service qui lance chaque serveur de jeu dans un conteneur | Go, Docker |
Ce guide installe les deux sur le même VPS pour Pterodactyl, sous Ubuntu LTS. Il suit la documentation officielle de Pterodactyl : en cas de doute sur une version (PHP notamment), c’est elle qui fait foi.
Prérequis :
- un VPS KVM avec accès root (Docker a besoin d’un vrai noyau) ;
- deux sous-domaines pointés vers l’IPv4 du VPS, par exemple
panel.example.cometnode.example.com; - une connexion SSH avec un utilisateur sudo (voir première connexion à un VPS).
1. Installer les dépendances du Panel
Sur Ubuntu 24.04 LTS, PHP 8.3, MariaDB, Redis et Nginx sont disponibles dans les dépôts officiels :
sudo apt update
sudo apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} \
mariadb-server nginx redis-server tar unzip git curl
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
Vérifiez que la version de PHP installée fait partie de celles prises en charge par la version du Panel que vous allez télécharger.
2. Télécharger le Panel
sudo mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
sudo curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
sudo tar -xzvf panel.tar.gz
sudo chmod -R 755 storage/* bootstrap/cache/
3. Créer la base de données
Ouvrez la console MariaDB avec sudo mariadb, puis créez l’utilisateur et la base. Remplacez le mot de passe par une valeur longue et aléatoire :
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'MotDePasseLongEtAleatoire';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
EXIT;
4. Configurer le Panel
cd /var/www/pterodactyl
sudo cp .env.example .env
sudo COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
sudo php artisan key:generate --force
sudo php artisan p:environment:setup
sudo php artisan p:environment:database
sudo php artisan p:environment:mail
sudo php artisan migrate --seed --force
sudo php artisan p:user:make
sudo chown -R www-data:www-data /var/www/pterodactyl/*
Les commandes p:environment posent des questions : URL du Panel (https://panel.example.com), pilote de cache et de sessions (Redis), identifiants de la base créée plus haut. p:user:make crée votre compte administrateur.
Sauvegardez la clé APP_KEY du fichier .env en lieu sûr : sans elle, les données chiffrées du Panel sont irrécupérables.
5. Tâche planifiée et file d’attente
Ajoutez la tâche planifiée du Panel avec sudo crontab -e :
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
Puis créez le service de file d’attente /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
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s
[Install]
WantedBy=multi-user.target
sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service
Pour le détail des services, voir créer un service systemd.
6. Nginx et HTTPS
Obtenez un certificat pour le Panel et pour le nœud avec Certbot :
sudo apt -y install certbot python3-certbot-nginx
sudo certbot certonly --nginx -d panel.example.com -d node.example.com
Créez ensuite /etc/nginx/sites-available/pterodactyl.conf à partir du modèle « Nginx avec SSL » de la documentation officielle, en remplaçant le nom de domaine et la version de PHP-FPM (php8.3-fpm.sock). Activez-le et rechargez Nginx :
sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl restart nginx
Le Panel répond maintenant sur https://panel.example.com. Connectez-vous avec le compte créé à l’étape 4.
7. Installer Docker et Wings
curl -sSL https://get.docker.com/ | sudo CHANNEL=stable bash
sudo systemctl enable --now docker
sudo mkdir -p /etc/pterodactyl
sudo curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64
sudo chmod u+x /usr/local/bin/wings
Si vous préférez installer Docker depuis son dépôt officiel, suivez notre guide installer Docker sur un VPS.
8. Créer le nœud dans le Panel
- Dans l’administration du Panel, créez une Location (par exemple « fr »).
- Créez un Node : FQDN
node.example.com, SSL activé, mémoire et disque totaux légèrement inférieurs à ceux du VPS. - Dans l’onglet Configuration du nœud, copiez le bloc affiché dans
/etc/pterodactyl/config.ymlsur le VPS. - Dans l’onglet Allocation, ajoutez l’IPv4 du VPS et une plage de ports pour vos jeux, par exemple 25565-25575.
Testez Wings au premier plan, qui affiche les erreurs éventuelles :
sudo wings --debug
Quand le nœud apparaît en vert (cœur battant) dans le Panel, arrêtez-le avec Ctrl+C et créez le service /etc/systemd/system/wings.service :
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service
[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s
[Install]
WantedBy=multi-user.target
sudo systemctl enable --now wings
9. Ouvrir les ports
| Port | Usage |
|---|---|
| 22/tcp | SSH |
| 80, 443/tcp | Panel (HTTP vers HTTPS) |
| 8080/tcp | API de Wings |
| 2022/tcp | SFTP des serveurs |
| Plage choisie | Ports de jeu (TCP et/ou UDP selon le jeu) |
sudo ufw allow 22/tcp
sudo ufw allow 80,443,8080,2022/tcp
sudo ufw allow 25565:25575/tcp
sudo ufw enable
Attention : Docker publie les ports des conteneurs en contournant en partie UFW. Ne comptez pas sur UFW seul pour masquer un port publié par un conteneur. Plus de détails dans configurer un pare-feu UFW.
10. Créer un premier serveur
Dans l’administration, menu Servers : choisissez le propriétaire, le nœud, une allocation, la RAM et le disque, puis le nest et l’egg du jeu (Minecraft Paper, par exemple). Pterodactyl télécharge l’image Docker, installe le jeu, et le serveur apparaît dans votre espace avec sa console.
D’autres eggs (Rust, Valheim, FiveM…) sont publiés par la communauté : importez-les depuis l’administration, et lisez-les avant de les utiliser, car un egg exécute un script d’installation sur votre nœud.
Maintenance
- Mettez à jour le Panel et Wings en suivant la procédure officielle de chaque version : elle peut inclure des migrations de base de données.
- Sauvegardez la base
panel, le fichier.envet le dossier/var/lib/pterodactyl/volumes, qui contient les données des serveurs. Voir stratégie de sauvegarde. - Surveillez la RAM et le disque : un serveur de jeu qui manque de mémoire est arrêté par le système.
Vous préférez un serveur de jeu prêt à l’emploi, sans administration ? Nos offres Minecraft, Rust ou FiveM sont livrées avec leur panel.
Questions fréquentes
Pterodactyl est-il gratuit ?
Oui, Pterodactyl est un logiciel open source distribué sous licence MIT. Vous payez seulement le serveur qui l’héberge.
Peut-on installer le Panel et Wings sur le même VPS ?
Oui. C’est la configuration la plus simple pour débuter ; d’autres nœuds Wings pourront être ajoutés plus tard sur d’autres serveurs.
Pourquoi Wings ne démarre-t-il pas ?
Lancez wings --debug pour lire l’erreur. Les causes les plus fréquentes sont un fichier config.yml absent ou mal copié, un certificat SSL manquant pour le nœud alors que le Panel est en HTTPS, ou Docker arrêté.
Quelle RAM prévoir ?
Le Panel se contente de peu de mémoire. Additionnez la RAM de chaque serveur de jeu prévu, ajoutez 1 à 2 Go pour le système et gardez de la marge.
Articles liés
VPS & Linux
Configurer un pare-feu sur votre VPS avec UFW
Configurer un pare-feu UFW sur un VPS Linux : autoriser SSH, ouvrir les ports utiles, activer et vérifier les règles. Guide sécurité pas à pas.
VPS & Linux
Créer un service systemd pour lancer une application au démarrage
Créer un service systemd sur un VPS : fichier .service, User, redémarrage automatique, activer au boot, logs avec journalctl. Guide pas à pas.
VPS & Linux
Gérer ses logs sur un VPS : journalctl et logrotate
Maîtrisez les logs de votre VPS : lire avec journalctl, limiter journald, faire tourner /var/log avec logrotate, éviter un disque plein. Avec l'angle RGPD.