Installer sur Pterodactyl

En bref. Tu importes dans ton panel Pterodactyl l'œuf d'Agora (le fichier qui explique au panel comment installer Agora), tu crées un serveur avec cet œuf, et tu le démarres. Tu n'as aucune base de données à préparer : Agora fournit et gère sa propre base dans le serveur, tu laisses simplement la variable « Base de donnees » vide. L'application se télécharge au premier démarrage, contre ta clé.

Avant de commencer #

• Un panel Pterodactyl dont tu es administrateur. Tu n'es pas sûr que ce soit Pterodactyl, ou tu n'as pas le menu Administration ? Lis d'abord Reconnaître Pelican ou Pterodactyl. Chez un hébergeur qui ne te laisse pas importer d'œuf, passe plutôt par un serveur Node.js.
• Ta clé de licence (elle commence par AGORA-). L'œuf téléchargé depuis ton espace la contient déjà. Pas de clé ? L'essai gratuit en est une vraie : voir L'essai gratuit de 14 jours.
• Les ressources du serveur : 2 Go de mémoire conseillés (1,5 Go au minimum) et 5 Go de disque (10 Go sont plus confortables), parce que le serveur fait tourner Agora et sa base de données. Avec moins, le panel risque d'arrêter le serveur en pleine activité.
• Une allocation de port : c'est l'adresse IP et le port que le panel réserve à ce serveur. C'est sur eux que tu ouvriras ton site.
• Une sortie vers Internet en HTTPS depuis le serveur (voir Prérequis).
• Les mots panel, œuf, nest, allocation et base de données sont dans le glossaire ; les deux bases d'Agora sont distinguées dans Les deux bases d'Agora.

Tu as déjà importé l'œuf d'Agora il y a longtemps ? L'ancien œuf déclarait la variable « Base de donnees » obligatoire : le panel refusait de créer un serveur sans elle. Le nouvel œuf la rend facultative. Réimporte l'œuf depuis ton espace avant de créer un nouveau serveur. Les serveurs déjà créés avec l'ancien œuf continuent de marcher tels quels. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre) ; comment réimporter sur un Pterodactyl qui a déjà l'ancien œuf (créer un second œuf puis supprimer l'ancien, ou mettre à jour l'œuf existant) : à vérifier -->

Étapes #

1. Ouvre la page d'installation de ton espace. Sur agorapanel.com, va à Installer sur mon panel (Mon espace → Installer sur mon panel). Sans clé, clique sur Obtenir ma clé d'essai gratuite.

2. Télécharge l'œuf Pterodactyl. Clique sur Œuf pour Pterodactyl. Le fichier agora-egg.json contient déjà ta clé : le site demande donc d'abord de vérifier ta session (voir Activer ou changer de clé), puis tu cliques de nouveau.

   <!-- CAPTURE C-039 -->

3. Importe-le dans Pterodactyl. Dans le panel, ouvre Administration → Nests (un nest est le dossier où le panel range ses œufs), choisis un nest, puis clique sur Import Egg et envoie le fichier. <!-- À CONFIRMER : parcours exact de l'import d'œuf sous Pterodactyl (démo officielle à vérifier, WORKFLOW phase 0 point 4) -->

   <!-- CAPTURE C-038 -->

4. Crée le serveur. Dans l'administration, ouvre Servers, puis Create New. Choisis le nœud (la machine qui fait tourner les serveurs du panel), une allocation libre, 2048 Mo de mémoire et 10240 Mo de disque, et sélectionne le nest et l'œuf Agora.

   <!-- CAPTURE C-040 -->

5. Regarde les variables du serveur. Elles s'affichent à la création, puis dans l'onglet Startup du serveur. Les noms sont en français et sans accents, c'est normal :

   • Cle de licence (AGORA_KEY) : doit contenir ta clé. Si tu as pris l'œuf public sans clé, colle-la ici ;
   • Base de donnees (DATABASE_URL) : laisse-la vide. Vide veut dire « utilise ta base intégrée » ;
   • Canal de mise a jour et Mettre a jour au demarrage : laisse les valeurs par défaut (stable et 0).

   <!-- CAPTURE C-041 -->

6. Ignore l'onglet Databases. Cet onglet du serveur crée une base MySQL, qui sert à la base de ton serveur de jeu, jamais à celle d'Agora. Ne t'en sers pas ici : le Hub attend du PostgreSQL, et il apporte déjà le sien.

   <!-- CAPTURE C-042 -->

7. Démarre le serveur. Clique sur Start et suis la console. Le premier démarrage prend quelques minutes : Agora télécharge sa base de données (une vingtaine de Mo) puis lui-même. Ne clique ni sur Stop ni sur Kill pendant ce temps. Tu verras défiler les étapes [1/6] Identité, [2/6] Licence, [3/6] Version, [4/6] Téléchargement, [5/6] Base de données, [6/6] Démarrage, puis la ligne ✓ Ready in …. <!-- À CONFIRMER : durée réelle du premier démarrage avec la base intégrée (mesure banc, BASE-INTEGREE §6) -->

   <!-- CAPTURE C-043 -->

8. Ouvre ton site. Dans l'onglet Network du serveur, repère l'allocation : une adresse IP et un port, par exemple 203.0.113.20:3020 (une adresse d'exemple : la tienne sera différente). Tape http:// devant, dans ton navigateur : http://203.0.113.20:3020. La console affiche aussi cette adresse sur la ligne adresse ; si elle montre une adresse locale (en 10.… ou 192.168.…), utilise celle de l'onglet Network.

   <!-- CAPTURE C-044 -->

9. Fais la mise en route. L'écran qui s'ouvre te guide en trois étapes : voir Faire la mise en route.

Tu sais que c'est réussi quand… #

• La console affiche ✓ base PostgreSQL intégrée prête, puis ✓ schéma à jour, puis ✓ Ready in ….
• Ton navigateur affiche l'écran Mise en route.
• http://IP:PORT/api/health répond "ok": true et "db": "ok".

Si ça ne marche pas #

Pour aller plus loin #

Ce qu'il ne faut pas changer #

• La commande de démarrage : node /home/container/boot.mjs.
• Les variables réservées à l'administrateur du panel : le « Hub de licences » (AGORA_HUB, ce n'est pas ton Hub mais le serveur de licences d'Agora) et le « Site de l'amorçage » (AGORA_SITE). Laisse aussi vide le « Secret d'authentification » (AUTH_SECRET) : Agora le génère au premier démarrage.
• Rien à modifier dans le config.yml de Wings (le programme du nœud qui exécute les ordres du panel), même pour la console d'Agora.

Où sont les données #

/home/container/
  boot.mjs      l'amorçage installé par l'œuf
  app/          l'application (retéléchargeable)
  app/.data/    pièces jointes, fichiers du MDT, sauvegardes .sql
  .agora/       identité de l'installation, bail de licence, secret de session,
                et ta base de données intégrée (dossier pg)

La base intégrée vit donc dans les fichiers du serveur : supprimer le serveur la supprime aussi. Perdre .agora/ fait passer l'installation pour une nouvelle machine. La copie de fichiers du panel (sauvegarde du serveur, archive, SFTP) n'est pas une sauvegarde de la base : elle copie une base en train de fonctionner, donc incohérente, et souvent inutilisable à la restauration. Seules font foi les sauvegardes d'Agora : voir Sauvegardes et restauration.

Le port de l'onglet txAdmin #

La variable Port de l'onglet txAdmin (AGORA_TXADMIN_PORT, 40121 par défaut) sert à l'onglet Serveur → txAdmin : mets-y le numéro d'une seconde allocation du serveur (la première sert au site). Tu peux l'ignorer si tu n'utilises pas cet onglet : voir txAdmin dans Agora.

Apporter ta propre base PostgreSQL (option avancée) #

Jamais nécessaire. Si tu possèdes déjà un serveur PostgreSQL joignable depuis le conteneur, tu peux coller son adresse dans la variable Base de donnees, de la forme postgresql://utilisateur:motdepasse@hote:5432/base?schema=public. Elle prime alors sur la base intégrée, qui ne démarre plus. Quelques règles :

• C'est du PostgreSQL, pas du MySQL : l'onglet Databases du panel ne convient pas.
• Crée la base et son utilisateur avant de démarrer ; Agora y crée tout le reste.
• Si le mot de passe contient des caractères spéciaux (@, :, /, #…), remplace-les par leur code (@ devient %40).
• 203.0.113.20 est une adresse d'exemple : mets la tienne.

Pour passer d'une base à l'autre en gardant tes données, voir Déménager Agora sur une autre machine. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre), BASE-INTEGREE §5 : procédure intégrée ↔ externe non éprouvée sur le banc -->

J'ai importé le mauvais œuf #

Si l'API du panel ne répond plus, tu as sans doute importé l'œuf de Pelican. Arrête le serveur, importe l'œuf Pterodactyl, change l'œuf du serveur sans le supprimer (sa base intégrée vit dans ses fichiers), puis supprime l'œuf importé par erreur quand plus aucun serveur ne l'utilise. <!-- À CONFIRMER : changer l'œuf d'un serveur existant sous Pterodactyl (onglet Startup de l'administration) -->