Contexte
Les Locations (emplacements) dans Pterodactyl permettent de regrouper et d'organiser vos différents Nodes (nœuds ou serveurs dédiés) par zone géographique, par infrastructure ou par centre de données. La création d'au moins une Location est une étape obligatoire avant de pouvoir configurer et lier un nouveau Node à votre panel.
1. Accéder au panel administrateur
Connectez-vous à votre panel Pterodactyl. Accédez à l'interface d'administration en cliquant sur l’icône engrenage située en haut à droite de votre écran.
2. Aller dans la section Locations
Dans le menu latéral gauche de l'administration :
- Cliquez sur l'onglet
.Locations - En haut à droite de la page de gestion, cliquez sur le bouton
.Create New
3. Remplir le formulaire de création
Complétez les deux champs requis pour identifier l'emplacement :
- Short Code : Saisissez un identifiant court et unique en minuscules (sans espaces ni caractères spéciaux). Ce code servira de repère technique et d'identifiant API.
Exemple :
oufr-pareu-west-1 - Description : Ajoutez un texte descriptif plus précis pour identifier facilement la localisation physique ou le prestataire de la machine.
Exemple :
Centre de données - Paris (Winheberg Infra)
Cliquez sur le bouton vert
Create
Une fois créée, la Location apparaîtra immédiatement dans la liste de sélection lors de la configuration de vos futurs serveurs ou nœuds de calcul.
En cas de problème
❌ Erreur "The short code has already been taken"
- Code déjà utilisé : Le
choisi est déjà attribué à une autre Location de votre panel. Les identifiants courts doivent obligatoirement être uniques pour éviter les conflits de routage ou d'API. Modifiez le code (par exemple en ajoutant un numéro :Short Code
).fr-par-2
❌ Impossible de supprimer une Location existante
- Nodes encore associés : Pterodactyl refuse par sécurité la suppression d'une Location si un ou plusieurs Nodes y sont encore rattachés. Vous devez d'abord modifier la configuration de vos Nodes pour les assigner à un autre emplacement, ou supprimer les Nodes vides avant de pouvoir effacer la Location.
Bonnes pratiques d'administration
- Adoptez une nomenclature claire : Utilisez des codes normalisés et standardisés basés sur la région géographique et un numéro d'index (ex:
pour un premier groupe de serveurs à Gravelines). Cela facilitera grandement la lecture de vos infrastructures si vous étendez votre parc de machines.eu-gra-1 - Regroupement logique : Si vous possédez plusieurs VPS ou serveurs dédiés chez le même fournisseur dans la même pièce, regroupez-les sous la même Location. Ne créez une nouvelle entité que s'il y a une réelle séparation géographique ou une différence majeure de réseau.
- Utilisation avec le déploiement automatique : Pterodactyl utilise les Locations pour distribuer automatiquement les nouveaux serveurs de jeu créés via l'API sur les Nodes les moins chargés d'une zone spécifique. Un ciblage précis des emplacements garantit une meilleure répartition des ressources de vos VPS.
Besoin d’aide ?
La structuration et la configuration des emplacements réseau sont essentielles pour maintenir une arborescence propre sur vos environnements de jeu.
Si vous rencontrez une erreur lors du déploiement de vos zones ou de l'association de vos machines, notre équipe reste à votre écoute. Ouvrez un ticket d'assistance depuis votre espace client sur billing.winheberg.com pour obtenir un diagnostic technique.
Votre nouvelle Location est désormais prête à accueillir ses premiers Nodes ! 🎮
