Guide d’installation de Pterodactyl (non officiel)

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 NodesCreate 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èmeCause possibleSolution
Panel inaccessibleDNS mal configuré ou FQDN incorrectVérifier la propagation DNS
Node non connectéPorts bloquésOuvrir les ports requis (8080, 2022, etc.)
Wings ne démarre pasSSL invalide ou config erronéeVérifier les logs : journalctl -u wings
Base de données KOMariaDB absent ou mal configuréVérifier systemctl status mariadb
Erreur SSLCertificat 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. 🎮🚀