GREENLIGHTVOTRE COMMUNAUTÉ. VOS UNIVERS.
DE LA MACHINE À LA PARTIE

Installer. Connecter. Jouer.

Le guide pour préparer ton infrastructure et déployer tes premiers serveurs.

01 / PRÉREQUIS

Une machine Linux prête à accueillir tes jeux.

L’agent est prévu pour Ubuntu 22.04 ou plus récent, ou Debian 12 ou plus récent, sur une machine x86_64 avec accès root et systemd.

  • Docker doit pouvoir utiliser les cgroups et monter des images ext4 en loop pour les quotas disque. Sur un VPS conteneurisé, vérifie que ces fonctions sont autorisées par ton hébergeur.
  • Prévois la RAM réelle de tes jeux et de la place pour leurs fichiers, les images Docker et le système. L’agent ne gère pas les services lancés en dehors du panel.
  • Autorise le port SSH et les ports TCP/UDP des jeux dans le pare-feu de la machine et de l’hébergeur. Seul SSH relie le panel à Docker : aucun port Docker public n’est nécessaire.
02 / CONNEXION DOCKER

Ajouter une machine distante.

  1. Dans Administration → Machines & Docker, ajoute son nom, son IP SSH, le port SSH, l’adresse publique et les capacités attribuables.
  2. Enregistre la machine. Sa page affiche une commande d’installation contenant sa clé publique dédiée.
  3. Connecte-toi à la machine distante en root, copie cette commande et exécute-la. Tu peux télécharger et lire le script avant de l’exécuter.
  4. Le script installe Docker, Python, l’agent et un compte glp-node. Sa clé SSH est limitée au service de gestion du panel.
  5. Retourne sur la page de la machine et clique sur Tester la connexion. Les métriques réelles et la version Docker doivent apparaître.

La première connexion mémorise l’identité SSH de la machine. Si l’hôte est réinstallé et sa clé change, un administrateur système doit vérifier cette nouvelle identité avant de retirer l’ancienne clé connue du stockage privé du panel.

Lire le script d’installation ↗

Hébergement local

Choisis le type Local uniquement pour la machine qui héberge Laravel. Son agent et sa règle sudo doivent être installés par l’administrateur système ; la machine locale initiale est déjà préparée.

03 / BASES DE DONNÉES

Un accès MySQL par serveur.

Le MariaDB local est disponible par défaut. Pour un MySQL distant, ouvre Administration → Hôtes MySQL → Ajouter, puis renseigne l’adresse vue par le panel, l’adresse accessible depuis les jeux et un compte de provisionnement.

Ce compte doit pouvoir créer des bases et des utilisateurs et accorder tous les privilèges sur ces bases. Restreins son accès réseau à l’IP du panel. Un administrateur MySQL peut créer un compte dédié plutôt que transmettre son compte personnel.

CREATE USER 'panel_provision'@'IP_DU_PANEL' IDENTIFIED BY 'UN_MOT_DE_PASSE_LONG';
GRANT ALL PRIVILEGES ON `glp\_%`.* TO 'panel_provision'@'IP_DU_PANEL' WITH GRANT OPTION;
GRANT CREATE USER ON *.* TO 'panel_provision'@'IP_DU_PANEL';

Teste ensuite la connexion. Depuis la page d’un serveur, le propriétaire peut créer jusqu’à dix bases. Chaque base possède un nom préfixé, un utilisateur et un mot de passe aléatoire. Ses droits portent sur cette base.

04 / PREMIER DÉPLOIEMENT

Choisir le jeu et lui faire de la place.

  1. Dans l’administration, clique sur Créer un serveur, puis choisis le propriétaire, le modèle de jeu et la machine.
  2. Définis la RAM en Mo, le nombre de cœurs, le quota disque, le port principal et les places. Les ports supplémentaires sont calculés selon le modèle.
  3. Complète les options affichées : version Minecraft, licence Cfx.re, mot de passe du jeu, monde… Accepte l’EULA pour Minecraft.
  4. L’installation démarre en arrière-plan. Le premier déploiement crée également l’image Docker ; il peut prendre plusieurs minutes. Consulte la console et attends l’état Arrêté.
  5. Clique sur Démarrer. Le jeu peut encore générer ses fichiers et son monde avant d’accepter les connexions. Utilise ensuite l’adresse publique affichée.

Les packs ATM 11, ATM 9 et Prominence II utilisent les archives serveur officielles CurseForge indiquées dans les modèles. Vanilla, Bedrock, Cfx.re et SteamCMD téléchargent leurs fichiers auprès de leurs sources officielles.

Modifier les ressources ou les ports arrête le serveur. Le disque peut être agrandi ; sa réduction reste bloquée pour protéger les données. Une réinstallation conserve les mondes et sauvegardes ; une suppression efface le volume et les bases du serveur.

Les modèles sont modifiables dans Jeux & installateurs. Une nouvelle version de modpack peut demander une autre version Java ou un autre chargeur : actualise ensemble l’archive et ses paramètres.

05 / PERMISSIONS

Chacun ses accès.

Crée un sous-compte ou invite un membre déjà inscrit depuis la section Accès partagés d’un serveur. La consultation est incluse ; l’alimentation, la console et les bases de données sont des permissions distinctes. Le propriétaire peut modifier ou retirer ces accès à tout moment.

Un administrateur gère l’ensemble des serveurs, les machines, les hôtes MySQL, les modèles et les comptes. Une inscription publique crée uniquement un compte utilisateur.

06 / VOS FICHIERS

Tout le nécessaire pour configurer ton serveur.

Ouvre un serveur puis l’onglet Fichiers. Tu peux parcourir les dossiers, créer un fichier ou un dossier, envoyer un fichier, renommer, déplacer et supprimer des éléments. L’envoi accepte un fichier jusqu’à 20 Mo et l’éditeur les textes UTF-8 jusqu’à 1 Mo.

Les modifications conservent l’indentation et le format des retours à la ligne. Le raccourci Ctrl+S ou Cmd+S enregistre le texte. Pour compresser, coche les éléments puis crée une archive ZIP. Le menu Actions d’une archive permet d’extraire un ZIP, un TAR ou un TAR.GZ.

Les permissions Lecture des fichiers, Écriture et Archives sont distinctes. Les dossiers internes et les liens symboliques ne sont pas ouverts depuis le gestionnaire.

07 / GARDER UNE COPIE

Un état précédent, prêt à retrouver.

L’onglet Sauvegardes permet de créer, télécharger et supprimer des archives. Chaque serveur dispose de cinq emplacements ordinaires. Une sauvegarde arrête le serveur pendant la copie puis le relance s’il était en marche. La progression reste visible pendant le travail en arrière-plan.

Pour restaurer, recopie le nom du serveur et confirme. Une copie de sécurité des fichiers actuels est créée avant leur remplacement. Le serveur reste arrêté après la restauration afin que tu puisses vérifier le résultat. Deux copies de sécurité peuvent être conservées ; supprime une ancienne copie pour libérer un emplacement.

Ces archives contiennent les fichiers du serveur, notamment les mondes et les configurations. Les bases MySQL ne sont pas incluses.

La consultation, le téléchargement, la création/suppression et la restauration disposent de permissions séparées. Restaurer nécessite également le droit de gérer l’alimentation.

08 / LES BONS AUTOMATISMES

Des actions à l’heure qui te convient.

Dans Planification, crée jusqu’à vingt tâches par serveur : démarrer, arrêter ou redémarrer, envoyer une commande du jeu, ou créer une sauvegarde. Choisis un rythme courant ou une expression cron à cinq champs, puis le fuseau UTC ou Europe/Paris.

Une tâche peut être mise en pause, modifiée, supprimée ou exécutée immédiatement. L’option « Seulement si le serveur est en ligne » évite d’envoyer une action lorsque le serveur est arrêté. L’historique indique le résultat des dernières exécutions.

Les droits du créateur sont revérifiés à chaque action. Une sauvegarde planifiée respecte la limite de cinq archives : libère un emplacement lorsque cette limite est atteinte. Deux exécutions de la même tâche ne se superposent pas.

9. Console en direct et surveillance

La console transmet les nouvelles lignes automatiquement. Utilise la recherche, le défilement automatique, l’export des lignes affichées et les flèches haut/bas pour retrouver les commandes saisies pendant la session. La permission « Lecture de la console » permet de consulter les journaux sans envoyer de commande.

Le processeur, la mémoire et le trafic réseau sont relevés chaque minute. Les graphiques affichent les dernières 24 heures ; les mesures sont conservées 48 heures. L’option de redémarrage après crash autorise trois tentatives. Un arrêt manuel ou une suspension empêche le redémarrage.

10. Réglages, ports et SFTP

Dans « Réglages & SFTP », arrête d’abord le serveur pour modifier Java, les options du jeu ou les ports. Seuls les administrateurs peuvent attribuer, ajouter, retirer ou changer les ports, y compris le port SFTP. Ce droit ne peut pas être délégué aux membres. Le quota de ports se règle dans l’administration. Les ports requis par le jeu sont protégés contre une suppression accidentelle ; une IPv4 précise doit déjà être attribuée à la machine.

Le propriétaire et les administrateurs peuvent activer le SFTP sur un port TCP dédié. Dans FileZilla ou WinSCP, choisis SFTP, l’adresse de la machine, le port affiché et l’utilisateur « panel ». Le mot de passe est affiché une seule fois : renouvelle-le si nécessaire. L’accès est isolé aux fichiers de ce serveur et reste soumis à son quota de stockage. Il faut ouvrir le port choisi dans le pare-feu de la machine.

11. Suspension, duplication et transfert

Un administrateur peut suspendre un serveur : le jeu et le SFTP sont arrêtés et les actions restent bloquées jusqu’à la levée de suspension. L’arrêt forcé nécessite une permission distincte et doit être réservé aux processus bloqués.

La duplication et le transfert arrêtent le serveur source, créent un instantané, vérifient l’empreinte des données et préparent une destination arrêtée. Un transfert copie aussi les sauvegardes disponibles puis supprime l’ancienne copie après validation. En cas d’échec avant validation, les données source sont conservées. Le SFTP doit être réactivé après l’opération. Les bases MySQL restent sur leur hôte existant et ne sont pas dupliquées : vérifie les connexions aux bases dans les fichiers d’une copie.

12. Importer et exporter les modèles de jeux

Dans « Jeux & installateurs », exporte un modèle au format JSON Greenlight pour le réutiliser sur un autre panel. L’import demande une catégorie et laisse le nouveau modèle masqué jusqu’à sa validation. Les eggs Pterodactyl v2 Minecraft Vanilla sont convertis vers l’installateur officiel intégré. Les autres eggs Pterodactyl ne sont pas compatibles et leurs scripts ne sont pas exécutés.

Après une mise à jour du panel, les machines distantes doivent recevoir les nouveaux fichiers de l’agent. Relance leur commande d’installation depuis leur page Machine ; les volumes des jeux sont conservés.

13. Installation Minecraft, mondes et extensions

L’onglet Minecraft permet de choisir Vanilla, Paper, Forge, NeoForge, Fabric ou un modpack autorisé par l’administration. Les versions viennent des catalogues officiels. Le panel choisit Java, crée une sauvegarde complète avant le changement et laisse le serveur arrêté à la fin. Le port et les quotas restent ceux attribués par l’administrateur. Le SFTP est suspendu pendant l’opération puis rétabli.

Un changement de pack utilise un nouveau monde. Pour mettre à jour le même pack, tu peux demander à conserver le monde. L’historique propose un retour aux fichiers et à la configuration précédents tant que sa sauvegarde existe. Deux sauvegardes de sécurité sont conservées au maximum : supprime la plus ancienne dans Sauvegardes pour libérer une place.

Les mondes peuvent être importés depuis un ZIP de 200 Mo maximum, sélectionnés ou régénérés avec une nouvelle seed. L’archive doit contenir un seul monde avec son level.dat et peut inclure ses dimensions. Les réglages du jeu proposent la difficulté, le mode de jeu, le PvP, la liste blanche, le vol, les distances et la conservation de l’inventaire.

La recherche de mods et plugins utilise Modrinth, filtré selon Minecraft et le chargeur. Les versions stables et leurs dépendances obligatoires sont vérifiées avant installation. Le serveur doit être arrêté ; l’installation se fait en arrière-plan. Les extensions présentes dans le pack peuvent aussi être activées, désactivées ou supprimées. Les gros fichiers dépassant 64 Mo se transfèrent par SFTP.

Les mises à jour sont vérifiées chaque jour à 08:00 UTC, sans migration automatique. Le diagnostic aide à identifier les erreurs courantes de Java, mémoire, dépendances, stockage ou ports ; la console conserve le détail. Une mise à jour de modpack nouvellement publiée peut nécessiter l’ajout de sa recette dans le catalogue administrateur.