Installer Pterodactyl sur un VPS : Panel et Wings

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

⚙️ 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

⚙️ 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

✅ 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

• Une étape bloque ou un nœud refuse de se connecter ? Notre support est là : ouvrez un ticket ou passez sur Discord.