Installer Pterodactyl sur un VPS : Panel et Wings
Guide complet pour installer le panel Pterodactyl et le daemon Wings sur un VPS Linux LordHosting : dépendances, base de données.
Pterodactyl est le panel d'hébergement de jeux open source le plus utilisé : une interface web moderne pour créer, gérer et isoler des serveurs de jeu dans des conteneurs Docker. Ce guide installe les deux composants - le Panel (l'interface) et Wings (le daemon qui exécute les serveurs) - sur un VPS Debian ou Ubuntu. Comptez environ 45 minutes.
⚙️ Prérequis
- Un VPS LordHosting en KVM, Debian 12 ou Ubuntu 22.04/24.04, 4 Go de RAM minimum
- Un nom de domaine ou sous-domaine pointant vers l'IP du VPS (ex.
panel.votredomaine.fr) - Un VPS déjà sécurisé - voir Sécuriser un VPS Linux
- Docker installé (requis pour Wings) - voir Installer Docker et Docker Compose
⚙️ 1. Installer les dépendances du Panel
Le Panel tourne sur PHP, une base de données et un serveur web. Installez le nécessaire :
sudo apt update
sudo apt install -y php8.3 php8.3-{cli,gd,mysql,pdo,mbstring,tokenizer,bcmath,xml,fpm,curl,zip} \
mariadb-server nginx redis-server git unzip
Installez ensuite Composer, le gestionnaire de dépendances PHP :
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
⚙️ 2. Créer la base de données
Ouvrez MariaDB et créez la base ainsi qu'un utilisateur dédié :
sudo mysql -u root
CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'UnMotDePasseSolide';
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;
exit
Remplacez UnMotDePasseSolide par un mot de passe fort et unique. Vous en aurez besoin à l'étape de configuration.
⚙️ 3. Télécharger et configurer 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/
sudo cp .env.example .env
sudo composer install --no-dev --optimize-autoloader
Générez la clé d'application puis lancez l'assistant de configuration :
sudo php artisan key:generate --force
sudo php artisan p:environment:setup
sudo php artisan p:environment:database
sudo php artisan migrate --seed --force
Créez enfin votre compte administrateur :
sudo php artisan p:user:make
Envie de mettre ce guide en pratique sur votre propre serveur ? Louer un VPS Ryzen gaming dès 8 €/mois chez LordHosting, en ligne en quelques minutes.
⚙️ 4. Configurer nginx et le SSL
Obtenez un certificat pour votre domaine, puis activez le virtualhost fourni par Pterodactyl :
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d panel.votredomaine.fr
Ajustez les permissions pour le serveur web :
sudo chown -R www-data:www-data /var/www/pterodactyl/*
Votre Panel est maintenant accessible sur https://panel.votredomaine.fr.
⚙️ 5. Installer Wings (le daemon)
Wings exécute les serveurs de jeu. Sur la machine qui les hébergera :
sudo mkdir -p /etc/pterodactyl
sudo curl -L -o /usr/local/bin/wings \
"https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo amd64 || echo arm64)"
sudo chmod u+x /usr/local/bin/wings
Dans le Panel, créez un Nœud (menu Admin → Nodes), puis copiez le fichier de configuration généré vers /etc/pterodactyl/config.yml. Démarrez Wings :
sudo wings --debug
Si la connexion au Panel s'établit sans erreur, créez le service systemd pour le lancer au démarrage :
sudo systemctl enable --now wings
Vérifiez que le port 8080 (et 2022 pour le SFTP) est ouvert dans votre firewall, et que le SSL du domaine est valide : Wings refuse de communiquer en HTTP non chiffré.
✅ Conclusion
Vous avez un Panel Pterodactyl fonctionnel et un premier nœud Wings prêt à héberger des serveurs de jeu. La suite se passe dans l'interface : créer un Nest, importer un Egg et déployer votre premier serveur - des étapes que nous détaillons dans nos autres guides Pterodactyl.
Pas envie de gérer l'installation vous-même ? Nos VPS Pterodactyl sont livrés avec le panel préinstallé et infogéré, prêts à l'emploi en quelques minutes.
❗Toujours bon à savoir
Mettez ce guide en pratique sur votre propre serveur
Dès 8 €/mois. En ligne en quelques minutes, protection anti-DDoS, support 7j/7, sans engagement.
Questions fréquentes
Guides similaires
Mettre à jour son VPS Pterodactyl
Guide détaillé pour mettre à jour votre VPS Pterodactyl vers la dernière version en toute sécurité : sauvegardes, prérequis, commandes et vérifications.
Planifier un redémarrage automatique
Comment configurer un redémarrage automatique quotidien de votre serveur Minecraft sur le panel LordHosting
Ajouter un Egg sur Pterodactyl
Guide étape par étape pour importer un Egg existant au format JSON sur Pterodactyl et ajouter de nouveaux jeux ou applications à votre panel d'hébergement.
Ajouter un utilisateur sur son VPS Pterodactyl
Guide complet pour créer, modifier et gérer les utilisateurs et permissions sur votre panel Pterodactyl LordHosting : rôles admin, accès serveurs, sécurité.

