Guide d’installation de Pterodactyl (non officiel)
Published on September 21, 2025 at 06:02 PM

Pterodactyl permet d’héberger et gérer facilement des serveurs de jeux via un panel web et un démon appelé Wings. Ce guide explique comment installer le panel, configurer Wings et relier un Node de manière sécurisée.
# Guide d’installation de Pterodactyl (non officiel)
## Sommaire
1. [Prérequis](#prérequis)
2. [Installation du panel](#installation-du-panel)
3. [Installation de Wings](#installation-de-wings)
4. [Configuration du Node](#configuration-du-node)
5. [Problèmes courants et solutions](#problèmes-courants-et-solutions)
6. [Bonnes pratiques](#bonnes-pratiques)
7. [Conclusion](#conclusion)
---
## Prérequis
Avant de commencer, assurez-vous d’avoir :
- Un VPS avec une distribution compatible :
- Ubuntu : 20.04, 22.04, 24.04
- Debian : 10, 11, 12
- Un accès root ou utilisateur avec sudo.
- Les paquets de base installés.
Mise à jour du système :
`apt update && apt upgrade -y`
Installation des dépendances :
`apt install sudo curl`
---
## Installation du panel
⚠️ Le script d’installation n’est pas recommandé en production publique.
👉 Utilisez-le pour une installation privée uniquement.
Lancer le script :
`bash <(curl -s https://pterodactyl-installer.se)`
Choisir l’option 0 pour installer le panel :
`* Input 0-8: 0`
Étapes d’installation :
1. Installer MariaDB :
`Would you like to install MariaDB (MySQL) server on the daemon as well? (y/N): y`
2. Laisser vide les champs base de données (mot de passe généré automatiquement).
3. Définir le fuseau horaire :
`Select timezone [Europe/Stockholm]: Europe/Paris`
4. Fournir une adresse mail valide :
`Provide the email address: [email protected]`
5. Créer le compte administrateur :
`Email: [email protected]`
`Username: admin`
`First name: admin`
`Last name: admin`
`Password: *****`
6. Indiquer le domaine ou l’IP du VPS :
`Set the FQDN: tuto.verycloud.fr`
7. Ne pas configurer UFW automatiquement :
`Do you want to automatically configure UFW (firewall)? (y/N): n`
8. Activer HTTPS avec Let’s Encrypt :
`Do you want to automatically configure HTTPS using Let's Encrypt? (y/N): y`
`I agree... (y/N): y`
9. Confirmer l’installation :
`Initial configuration completed. Continue with installation? (y/N): y`
`(A)gree/(C)ancel: a`
✅ Le panel est installé.
---
## Installation de Wings
Relancer le script :
`bash <(curl -s https://pterodactyl-installer.se)`
Choisir l’option 1 pour installer Wings :
`* Input 0-8: 1`
Étapes d’installation :
1. Ne pas réinstaller MariaDB :
`Would you like to install MariaDB... (y/N): n`
2. Ne pas configurer UFW automatiquement :
`Do you want to automatically configure UFW (firewall)? (y/N): n`
3. Configurer HTTPS avec Let’s Encrypt :
```
Do you want to automatically configure HTTPS... (y/N): y
Set the FQDN: node.verycloud.fr
I agree... (y/N): y
Enter email address: [email protected]
Proceed with installation? (y/N): y
```
✅ Wings est installé.
---
## Configuration du Node
1. Se connecter au panel (ex. `tuto.verycloud.fr`).
2. Aller dans **Locations** → créer une location (nom libre).
3. Dans **Nodes** → *Create New* et remplir :
- Name : nom du node
- FQDN : IP ou domaine
- Connexion : HTTP si pas de SSL, sinon SSL
- Total Memory : ex. 1024MB = 1 Go
- Total Disk Space : stockage disponible
- Over-Allocation : pourcentage (0 si inutile)
4. Créer le Node → onglet Configuration.
5. Générer un Token → copier la commande.
6. Exécuter la commande dans le VPS (SSH).
Activer Wings :
`systemctl enable --now wings`
`systemctl start wings`
---
## Problèmes courants et solutions
| Problème | Cause possible | Solution |
|---|---|---|
| Panel inaccessible | DNS mal configuré ou FQDN incorrect | Vérifier la propagation DNS |
| Node non connecté | Ports bloqués | Ouvrir les ports requis (8080, 2022, etc.) |
| Wings ne démarre pas | SSL invalide ou config erronée | Vérifier les logs : `journalctl -u wings` |
| Base de données KO | MariaDB absent ou mal configuré | Vérifier `systemctl status mariadb` |
| Erreur SSL | Certificat Let’s Encrypt non généré | Vérifier que le domaine pointe bien vers le VPS |
---
## Bonnes pratiques
- Utiliser un nom de domaine valide (panel + nodes).
- Toujours activer HTTPS (Let’s Encrypt ou certificat valide).
- Mettre à jour régulièrement :
`apt update && apt upgrade -y`
- Créer des comptes utilisateurs dédiés, éviter d’utiliser toujours l’admin.
- Sauvegarder la base de données et la configuration régulièrement.
---
## Conclusion
L’installation de Pterodactyl avec son panel et son démon Wings est simple grâce au script, mais nécessite une bonne configuration réseau et SSL.
En suivant ce guide et les bonnes pratiques, vous obtiendrez une plateforme fiable et sécurisée pour héberger vos serveurs de jeux. 🎮🚀


















