🎮 Installer Pterodactyl sur son VPS LibraHost#

Installez Pterodactyl Panel et Wings sur votre VPS LibraHost grâce à un script d'installation automatique. Gérez facilement vos serveurs de jeux (Minecraft, Garry's Mod, CS2, etc.) depuis une interface web moderne !

🎯 Objectif#

Préparer le VPS pour l'installation
Installer le Panel Pterodactyl (interface web d'administration)
Installer Wings (daemon qui gère les serveurs de jeux)
Configurer le pare-feu
Créer votre premier utilisateur administrateur

🧰 Prérequis#

Un VPS LibraHost avec minimum 2 Go de RAM et 20 Go de stockage
Un système d'exploitation supporté :
- Ubuntu 22.04 ou 24.04 (recommandé)
- Debian 10, 11, 12 ou 13
- Rocky Linux 8 ou 9
- AlmaLinux 8 ou 9
Accès root au VPS (via SSH)
L'adresse IPv4 de votre VPS

⚠️ Important : Ce guide utilise l'adresse IPv4 du VPS sans certificat SSL. Pour un environnement de production avec nom de domaine et HTTPS, consultez la documentation officielle de Pterodactyl.

1️⃣ Préparation du VPS#

🔹 Se connecter en SSH#

ssh root@VOTRE_IP_VPS

🔹 Mettre à jour le système#

apt update && apt upgrade -y

🔹 Installer les dépendances de base#

apt install -y curl wget sudo

2️⃣ Lancer le script d'installation#

🔹 Exécuter le script automatique#

Lancez la commande suivante en tant que root :

bash <(curl -s https://pterodactyl-installer.se)

Le script affiche un menu avec plusieurs options :

[0] Install the panel
[1] Install Wings
[2] Install both [0] and [1] on the same machine

🔹 Choisir l'option d'installation#

Option	Description	Recommandation
0	Installe uniquement le Panel (interface web)	Si vous séparez Panel et Wings sur deux VPS
1	Installe uniquement Wings (daemon)	Pour un node secondaire
2	Installe le Panel ET Wings sur la même machine	✅ Recommandé pour débuter

💡 Recommandation : Pour commencer, choisissez l'option 2 pour installer les deux composants sur le même VPS.

3️⃣ Configuration du Panel#

Après avoir choisi l'option, le script vous pose plusieurs questions :

🔹 Configuration de la base de données#

Database name (panel): panel
Database username (pterodactyl): pterodactyl
Database password: VotreMotDePasseSecurisé

💡 Astuce : Utilisez un mot de passe fort pour la base de données. Notez-le précieusement !

🔹 Configuration du fuseau horaire#

Select timezone: Europe/Paris

🔹 Configuration de l'email#

Email address for the initial admin account: [email protected]

🔹 Configuration de l'utilisateur administrateur#

Username (admin): admin
First name: Votre
Last name: Nom
Password: VotreMotDePasseAdmin

⚠️ Important : Notez bien ces identifiants, vous en aurez besoin pour vous connecter au panel !

🔹 Configuration du FQDN (nom de domaine)#

Comme nous utilisons uniquement l'IPv4 :

FQDN (e.g panel.example.com): VOTRE_IP_VPS

Entrez simplement l'adresse IP de votre VPS (ex : 51.178.xxx.xxx).

🔹 Configuration SSL#

Do you want to configure Let's Encrypt automatically? (y/N): N

Répondez N car nous n'utilisons pas de nom de domaine.

🔹 Configuration du pare-feu#

Do you want to automatically configure UFW? (y/N): y

Répondez y pour configurer automatiquement le pare-feu.

4️⃣ Configuration de Wings#

Si vous avez choisi l'option 2, le script enchaîne avec l'installation de Wings :

🔹 Configuration du FQDN pour Wings#

FQDN (e.g node.example.com): VOTRE_IP_VPS

Entrez la même adresse IP que pour le panel.

🔹 Configuration SSL pour Wings#

Do you want to configure Let's Encrypt automatically? (y/N): N

Répondez N.

🔹 Configuration du pare-feu pour Wings#

Do you want to automatically configure UFW? (y/N): y

Répondez y.

🔹 Configuration de la base de données MySQL pour les hôtes#

Do you want to configure MySQL to be used by hosts? (y/N): y

Répondez y si vous souhaitez que vos serveurs de jeux puissent utiliser MySQL.

5️⃣ Finaliser la configuration de Wings#

Une fois l'installation terminée, vous devez connecter Wings au Panel :

🔹 Accéder au panel#

Ouvrez votre navigateur et accédez à :

http://VOTRE_IP_VPS

Connectez-vous avec les identifiants administrateur créés précédemment.

🔹 Créer un Node (Location)#

Allez dans Admin (icône engrenage en haut à droite)
Cliquez sur Locations dans le menu de gauche
Cliquez sur Create New
Remplissez :
- Short Code : local
- Description : Serveur local
Cliquez sur Create

🔹 Créer le Node#

Cliquez sur Nodes dans le menu de gauche
Cliquez sur Create New
Remplissez les informations :

Champ	Valeur
Name	Node-01
Location	Serveur local
FQDN	VOTRE_IP_VPS
Communicate Over SSL	❌ Décoché (HTTP)
Behind Proxy	❌ Décoché
Total Memory	RAM de votre VPS en Mo (ex : 4096)
Memory Over-Allocation	0
Total Disk Space	Espace disque en Mo (ex : 50000)
Disk Over-Allocation	0

Cliquez sur Create Node

🔹 Récupérer la configuration Wings#

Cliquez sur le node que vous venez de créer
Allez dans l'onglet Configuration
Cliquez sur Generate Token
Copiez la commande affichée

🔹 Appliquer la configuration sur le VPS#

De retour dans votre terminal SSH, collez et exécutez la commande copiée. Elle ressemble à :

cd /etc/pterodactyl && sudo wings configure --panel-url http://VOTRE_IP_VPS --token VOTRE_TOKEN --node 1

🔹 Démarrer Wings#

sudo systemctl enable --now wings

Vérifiez que Wings fonctionne :

sudo systemctl status wings

6️⃣ Ajouter des allocations (ports)#

Pour créer des serveurs de jeux, vous devez allouer des ports :

Dans le panel, allez dans Admin > Nodes
Cliquez sur votre node
Allez dans l'onglet Allocation
Remplissez :
- IP Address : 0.0.0.0
- Ports : 25565-25575 (pour Minecraft par exemple)
Cliquez sur Submit

💡 Astuce : Vous pouvez ajouter plusieurs plages de ports selon vos besoins (ex : 27015-27020 pour les serveurs Source).

7️⃣ Ouvrir les ports dans le pare-feu#

Pour chaque plage de ports allouée, ouvrez-les dans UFW :

sudo ufw allow 25565:25575/tcp
sudo ufw allow 25565:25575/udp

Vérifiez l'état du pare-feu :

sudo ufw status

8️⃣ FAQ & problèmes courants#

Erreur "Wings is not connected" ? Vérifiez que Wings est démarré avec systemctl status wings. Assurez-vous que le FQDN dans le node correspond bien à l'IP du VPS.
Impossible d'accéder au panel ? Vérifiez que les ports 80 et 443 sont ouverts (ufw allow 80/tcp). Vérifiez que nginx fonctionne (systemctl status nginx).
Les serveurs de jeux ne démarrent pas ? Vérifiez que les ports sont alloués dans le panel ET ouverts dans le pare-feu. Consultez les logs avec docker logs <container_id>.
Erreur de connexion à la base de données ? Le script a peut-être été exécuté plusieurs fois. Réinstallez le système et relancez le script sur un VPS fraîchement installé.
Comment mettre à jour Pterodactyl ? Consultez la documentation officielle sur pterodactyl.io pour les mises à jour du panel et de Wings.

✅ Conclusion#

Votre panel Pterodactyl est maintenant installé et prêt à l'emploi ! Vous pouvez créer vos premiers serveurs de jeux depuis l'interface web. N'oubliez pas d'installer les "Eggs" (templates de serveurs) correspondant aux jeux que vous souhaitez héberger. Pour plus d'informations, consultez la documentation officielle de Pterodactyl.

Thème

Langue

Documentation

Navigation