Premiers pas sur votre panel Pterodactyl : du compte admin au premier serveur

Votre VPS Pterodactyl est livré avec le panel et son agent, Wings, déjà installés et reliés. Il reste à préparer le panel puis à créer vos serveurs de jeu. Ce guide suit l'ordre logique de la première prise en main, de la connexion jusqu'au premier serveur en ligne. Les menus du panel sont en anglais : leurs noms sont donnés tels quels.

1. Se connecter et sécuriser le compte admin

L'adresse du panel et les identifiants du compte administrateur sont disponibles dans votre espace client me.nvhcloud.com. Connectez-vous, puis ouvrez votre compte (icône en haut à droite) :

• changez le mot de passe initial pour un mot de passe long et unique ;
• activez la double authentification (Two-Step Verification) avec une application comme Google Authenticator ou Aegis. Ce compte contrôle tous vos serveurs : il mérite cette protection.

Le compte admin donne accès à la zone d'administration, par l'icône en forme d'engrenage ou à l'adresse /admin du panel. C'est là que se font les étapes 2 à 6.

2. Vérifier que le nœud est en ligne

Dans Pterodactyl, la machine qui fait tourner les serveurs s'appelle un nœud (Node). Ouvrez Nodes dans l'administration : votre nœud doit afficher un cœur vert, signe que le panel communique avec Wings. Un cœur rouge indique que Wings ne répond pas ; vérifiez-le en SSH :

systemctl status wings
journalctl -u wings -n 50 --no-pager

Un systemctl restart wings règle la plupart des cas. Si l'erreur persiste après une modification de votre part (certificat, nom de domaine, pare-feu), le journal indique presque toujours la cause.

3. Ajouter des ports (allocations)

Chaque serveur de jeu a besoin d'au moins un couple adresse IP et port, appelé allocation. Dans Nodes, ouvrez votre nœud, puis l'onglet Allocation. Indiquez l'adresse IP du VPS et les ports à créer, un par un ou en plage :

Créez-en un peu plus que nécessaire : certains jeux demandent un second port, pour la requête de statut ou la console à distance. Si vous avez activé un pare-feu sur le VPS, ouvrez-y aussi ces ports, en TCP et en UDP, ainsi que les ports du panel (80 et 443), de Wings (8080) et du SFTP (2022). Voir configurer UFW.

4. Importer un egg

Un egg est le modèle qui décrit comment installer et lancer un jeu : image Docker, script d'installation, commande de démarrage et variables. Les eggs fournis d'origine sont rangés par familles (Nests) : Minecraft, Rust, jeux Source et serveurs vocaux. Pour un jeu absent, comme FiveM ou Palworld, récupérez son egg au format JSON dans le dépôt communautaire pelican-eggs sur GitHub, puis, dans Nests, cliquez sur Import Egg et choisissez le fichier et la famille de destination.

5. Créer un serveur de jeu

Dans Servers, cliquez sur Create New et remplissez le formulaire de haut en bas :

1. Nom et propriétaire : le propriétaire (Server Owner) est le compte qui verra le serveur dans son tableau de bord, le vôtre ou celui d'un client.
2. Allocation : choisissez le port principal créé à l'étape 3, et des ports supplémentaires si le jeu en a besoin.
3. Limites : processeur, mémoire et disque, voir l'étape suivante.
4. Nest et Egg : le jeu à installer. Les variables propres au jeu apparaissent en bas du formulaire (version, nom du serveur, clé de licence pour FiveM, jeton Steam pour certains jeux).

À la validation, le serveur passe en installation : Wings télécharge l'image et les fichiers du jeu. Suivez la progression dans la console du serveur ; quand elle se termine, démarrez-le. Si l'installation bloque, consultez notre guide des erreurs SteamCMD à l'installation.

6. Régler les limites de ressources

• CPU Limit : en pourcentage d'un cœur. 100 correspond à un cœur, 200 à deux cœurs ; 0 retire toute limite.
• Memory et Disk Space : en Mio. Laissez au moins 1 à 2 Go de mémoire libre pour le système, le panel et Wings.
• Database, Allocation et Backup Limit : le nombre de bases de données, de ports supplémentaires et de sauvegardes que le serveur peut créer lui-même. Ces trois valeurs valent 0 par défaut : sans les augmenter, les boutons de création de base et de sauvegarde restent inactifs.

Toutes ces valeurs se modifient après coup, depuis la fiche du serveur dans l'administration, onglet Build Configuration.

7. Gérer les fichiers et se connecter en SFTP

L'onglet Files du serveur permet d'éditer et de déposer des fichiers depuis le navigateur. Pour les gros transferts (monde Minecraft, ressources FiveM, cartes), passez en SFTP : les informations sont dans l'onglet Settings du serveur.

• Hôte : l'adresse du VPS, port 2022 (et non 22, réservé à l'accès SSH du VPS) ;
• Identifiant : votre nom d'utilisateur suivi d'un point et de l'identifiant court du serveur, par exemple admin.1a2b3c4d ;
• Mot de passe : celui de votre compte du panel.

Des bases de données MySQL peuvent aussi être créées depuis l'onglet Databases, à condition qu'un serveur de bases soit déclaré dans Databases côté administration. Pour en installer un proprement, voir sécuriser MariaDB.

8. Sauvegardes et tâches planifiées

Une fois la limite de sauvegardes réglée, l'onglet Backups crée une archive du serveur en un clic, à faire avant chaque mise à jour du jeu ou de vos mods. Ces archives restent sur le VPS : pour une vraie sécurité, copiez régulièrement les plus importantes ailleurs, voir sauvegardes avec Borg.

L'onglet Schedules automatise les opérations récurrentes. Une tâche se définit comme une ligne cron (minute, heure, jour) et enchaîne des actions : envoyer une commande dans la console, démarrer, arrêter ou redémarrer le serveur, créer une sauvegarde. Exemple utile : un redémarrage chaque nuit à 5 h, précédé d'un message d'avertissement aux joueurs. Il libère la mémoire des jeux qui en consomment de plus en plus avec le temps.

9. Donner accès à d'autres personnes

Pour un membre de votre équipe, ouvrez l'onglet Users du serveur concerné et invitez-le par e-mail, en cochant uniquement les permissions utiles : console, fichiers, démarrage, sauvegardes. Il n'a ainsi jamais accès à l'administration.

Pour un client à qui vous louez un serveur, créez-lui un compte dans Users côté administration, puis désignez-le comme propriétaire de son serveur. Il ne voit que les serveurs qui lui appartiennent.

Questions fréquentes