Installer Pterodactyl sur un serveur dédié : guide complet pour FiveM

Pterodactyl est le panel de gestion open source le plus utilisé pour héberger des serveurs de jeux, FiveM compris. Si votre serveur FiveM tourne déjà chez ElypseCloud, Pterodactyl est préinstallé sur l'offre : ce guide ne vous concerne pas directement. Il s'adresse à ceux qui veulent installer leur propre instance Pterodactyl sur un serveur dédié ou un VPS, pour gérer eux-mêmes plusieurs serveurs de jeu (FiveM ou autres) depuis un seul panel.

Panel et Wings : les deux briques de Pterodactyl

Pterodactyl se compose de deux logiciels distincts, souvent confondus :

• Le Panel : l'interface web (PHP/Laravel) où vous créez des comptes, gérez les serveurs et allouez les ressources. C'est ce qu'on installe en premier.
• Wings : le démon qui tourne sur chaque machine hébergeant réellement les serveurs de jeu. Il communique avec le Panel et lance chaque serveur dans un conteneur Docker isolé.

Sur une installation simple, Panel et Wings tournent sur la même machine. Sur une infrastructure plus grande, le Panel pilote plusieurs machines (nodes), chacune avec sa propre instance Wings.

Prérequis

• Un serveur dédié ou un VPS Linux avec accès root, sous une distribution supportée par la documentation officielle au moment de l'installation (Ubuntu et Debian récents, RHEL/Rocky/AlmaLinux le sont à l'écriture de ce guide).
• PHP en version récente avec les extensions requises par Pterodactyl (la doc officielle liste la version exacte attendue, elle change à chaque version majeure du Panel).
• MySQL ou MariaDB, Redis, un serveur web (Nginx ou Apache), Composer.
• Docker, nécessaire uniquement pour Wings (pas pour le Panel lui-même).
• Un nom de domaine ou sous-domaine pointé sur le serveur, pour poser un certificat SSL sur le Panel.

Installer le Panel

Il n'existe pas de script d'installation officiel en une commande : l'installation du Panel se fait à la main, en suivant la documentation. Dans les grandes lignes :

1. Installez les dépendances (PHP et ses extensions, Composer, Redis, votre serveur web, les utilitaires curl/tar/unzip/git).
2. Créez la base de données et l'utilisateur MySQL/MariaDB dédiés au Panel.
3. Récupérez les fichiers du Panel et installez les dépendances PHP via Composer.
4. Lancez la configuration interactive (fichier d'environnement, connexion à la base, création du compte administrateur) via les commandes artisan fournies par le Panel.
5. Configurez votre serveur web pour servir le Panel, avec un certificat SSL (Let's Encrypt convient très bien).
6. Mettez en place la tâche planifiée (cron) et le service de file d'attente que le Panel attend pour fonctionner correctement en arrière-plan.

Chaque commande exacte est documentée pas à pas sur pterodactyl.io, avec des variations selon votre OS et votre serveur web : c'est la référence à suivre à la lettre, plutôt qu'une suite de commandes recopiées d'un tutoriel qui peut dater de plusieurs versions.

Installer Wings et l'ajouter au Panel

Une fois le Panel accessible, deux étapes restent avant de pouvoir héberger un premier serveur :

1. Installer Docker sur la machine qui exécutera Wings (le Panel et Wings peuvent être sur la même machine ou séparés).
2. Déclarer un node dans le Panel : c'est là que vous configurez l'adresse de la machine, la plage de ports allouée aux serveurs de jeu qui y tourneront, et que vous récupérez le fichier de configuration à copier sur la machine pour démarrer Wings.

Une fois Wings démarré et connecté, le node passe en ligne dans le Panel : vous pouvez créer votre premier serveur.

Ajouter un serveur FiveM via un Egg

Pterodactyl installe un jeu à partir d'un Egg : un modèle qui décrit comment télécharger, configurer et démarrer ce jeu précis dans le conteneur Docker. Il existe des eggs communautaires pour FiveM (recherchez-les avant l'installation et vérifiez leur maintenance récente, un egg abandonné cassera au premier changement côté Cfx.re). Une fois l'egg importé dans le Panel :

1. Créez un nouveau serveur, choisissez le node et l'egg FiveM.
2. Allouez les ressources (CPU, RAM, disque) et un port réseau depuis la plage définie sur le node.
3. Laissez Wings télécharger et installer les fichiers FiveM dans le conteneur.
4. Une fois le serveur créé, configurez-le comme n'importe quel serveur FiveM : server.cfg, framework RP (voir notre guide d'installation ESX Legacy si vous partez de zéro), ressources.

Sécuriser votre installation

• Pare-feu : n'ouvrez que les ports réellement nécessaires (HTTPS du Panel, plage de ports des serveurs de jeu, port de Wings). Fermez tout le reste.
• SSL partout : Panel et Wings communiquent en HTTPS, un certificat expiré ou absent casse la connexion entre les deux.
• Mises à jour régulières : Panel, Wings et Docker reçoivent des correctifs de sécurité. Un Panel laissé à l'abandon pendant des mois est une cible facile.
• Comptes et permissions : donnez à chaque administrateur son propre compte plutôt que de partager les identifiants root du Panel.

Et si vous n'avez pas envie de gérer tout ça vous-même ?

Auto-héberger Pterodactyl a un intérêt réel si vous gérez plusieurs serveurs de jeu pour vous ou pour des clients. Si votre seul besoin est de faire tourner un serveur FiveM, la maintenance du Panel et de Wings (mises à jour, sécurité, sauvegardes) est du temps qui ne sert pas votre communauté. Nos offres FiveM livrent un Pterodactyl déjà configuré et maintenu par nos équipes, prêt à l'emploi dès la commande. L'essai gratuit 48h permet de voir le panel tourner avant de choisir votre camp.