Installation automatique sur ton panel

En bref. La page Installer sur mon panel de ton espace sait réinstaller un serveur de ton panel pour toi : elle teste ta clé d'API, te montre les serveurs qui peuvent accueillir Agora, puis relance l'installation de celui que tu choisis. Tout ce qu'il contenait est effacé. Cette voie ne change pas l'œuf du serveur et ne pose pas ta clé de licence : elle suppose donc que le serveur a déjà été créé avec l'œuf d'Agora.

<!-- À CONFIRMER : AUT-1. Code vérifié (panel-deploy.ts, panel-core.ts) : l'appel au panel renvoie l'œuf actuel du serveur (egg: current.egg), ne fusionne que AGORA_INSTALL=panel (variable que boot.mjs ne lit pas) aux variables existantes, puis réinstalle. Sur un serveur dont l'œuf n'est pas celui d'Agora, le script d'installation de cet autre œuf ne dépose pas boot.mjs : serveur mort probable. À confirmer par un test sur le banc Pelican ; si confirmé, défaut produit à remonter (le titre de la page du site dit « Installer Agora sur mon panel »). -->

Avant de commencer #

• Pour une première installation, prends plutôt l'œuf. Importer l'œuf puis créer le serveur est la voie normale : Installer sur Pterodactyl ou Installer sur Pelican. L'installation automatique sert surtout à réinstaller proprement un serveur qui a déjà l'œuf d'Agora et sa clé.

• Un serveur déjà créé avec l'œuf d'Agora, dont la variable Cle de licence est remplie. Si ce serveur contient déjà un Hub, sa base de données intégrée disparaît aussi : fais d'abord une sauvegarde d'Agora et télécharge-la hors du serveur (voir Sauvegardes et restauration).

• Un panel public, en HTTPS. Le site doit pouvoir joindre ton panel par Internet : une adresse qui commence par https:// et qui s'ouvre depuis n'importe où. Un panel installé sur ton réseau local n'est pas accepté ici. Pour un panel local, utilise l'œuf.

• Un serveur avec assez de ressources : au moins 1,5 Go de mémoire et 5 Go de disque (2 Go et 10 Go sont plus confortables), parce que le serveur fait tourner Agora et sa base de données. Les serveurs trop petits sont grisés dans la liste.

• Une clé d'API du panel. Une clé d'API est un jeton que tu crées dans ton panel pour qu'un programme le pilote. Il y en a deux sortes, la première étant recommandée :

  • la clé d'administration : Administration → Application API → Create New, avec les droits de lecture et d'écriture sur « Servers » ;
  • la clé de compte : Account → API Credentials → Create. Elle ne peut pas changer l'œuf du serveur, mais cela ne gêne pas ici, puisque l'œuf doit déjà être le bon.

  <!-- À CONFIRMER : AUT-3, chemin exact de la clé d'API d'administration sous Pelican (il est valable pour Pterodactyl), vérification banc -->

  <!-- CAPTURE C-061 -->

  <!-- CAPTURE C-060 -->

  <!-- CAPTURE C-062 -->

• Tu ne sais pas si ton panel est Pterodactyl ou Pelican ? Voir Reconnaître Pelican ou Pterodactyl.

Étapes #

1. Ouvre la page d'installation de ton espace. Sur agorapanel.com, va à Installer sur mon panel (Mon espace → Installer sur mon panel). Si ce n'est pas fait, prépare ta clé de licence avec Obtenir ma clé d'essai gratuite.

2. 1. Brancher le panel. Colle l'adresse du panel (par exemple panel.monhebergeur.com, en HTTPS) et la clé d'API, puis clique sur Tester la connexion. Rien n'est enregistré tant que le test n'a pas réussi.

   <!-- CAPTURE C-056 -->

3. 2. Choisir le serveur. Le site affiche le type de clé reconnu et la liste des serveurs du panel. Les serveurs trop petits, suspendus ou en cours de transfert sont grisés, avec la raison.

   <!-- CAPTURE C-057 -->

4. 3. Confirmer, cette étape efface le serveur. Choisis le serveur, lis l'avertissement rouge, tape le mot demandé (ECRASER), puis clique sur Écraser ce serveur et installer Agora.

   <!-- CAPTURE C-058 -->

5. Suis l'avancement dans la console de ton panel. Le site affiche « Installation lancée » : le panel réinstalle le serveur, et Agora démarre dès que l'installation est terminée. Ta clé d'API est alors effacée de chez nous. Si la console dit qu'il manque la clé de licence, renseigne-la dans les variables de démarrage du serveur (variable AGORA_KEY) : tu la retrouves sur la même page (Afficher la clé), puis redémarre le serveur. L'installation automatique ne pose jamais ta clé de licence.

   <!-- CAPTURE C-059 -->

6. Fais la mise en route. Quand la console affiche ✓ Ready in …, ouvre http://IP:PORT (l'adresse du serveur dans ton panel) : voir Faire la mise en route.

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

• Le site affiche Installation lancée.
• La console du serveur, dans ton panel, repasse par l'installation puis affiche ✓ Ready in ….
• Ton navigateur affiche l'écran Mise en route.

Si ça ne marche pas #

<!-- À CONFIRMER : dernière ligne du tableau (AUT-1), effet réel d'une réinstallation sur un serveur dont l'œuf n'est pas celui d'Agora ; messages d'erreur du tableau à relire après le test banc (AUT-5) -->

Pour aller plus loin #

• Ce que fait la clé d'administration. Avec elle, le site pose sur le serveur l'image Node d'Agora (ghcr.io/parkervcp/yolks:nodejs_22) et la commande de démarrage (node /home/container/boot.mjs), sans toucher à ses autres variables, puis relance l'installation. Avec une clé de compte, il ne change rien d'autre que le lancement de la réinstallation.
• Ce que le site garde de ta clé. Elle n'est enregistrée, chiffrée, qu'après un test réussi. Elle est effacée dès la fin de l'installation, et au plus tard une heure après le test si tu ne vas pas au bout.
• Un serveur en marche est arrêté avant la réinstallation : la liste te le signale.
• Pourquoi pas pour une première installation ? Parce que cette voie ne pose ni l'œuf ni la clé de licence. Elle réutilise ce qui est déjà sur le serveur.