Vérifier les prérequis avant d'installer Agora

En bref. Quatre choses sont obligatoires : un endroit où faire tourner Agora, une clé de licence, un accès à Internet et un compte Discord. Aucune base de données n'est à préparer pour Agora lui-même. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre) --> La base de ton serveur de jeu et l'accès à ton serveur FiveM ne servent qu'au MDT et à la tablette.

Avant de commencer #

• Tu n'as rien à installer pour lire cette page : tu vérifies seulement que tout est prêt.
• Un mot technique t'arrête ? Il est expliqué dans le glossaire.
• Tu ne sais pas encore où installer Agora ? Lis d'abord Choisir entre Docker, l'œuf de panel et un serveur Node.js.

Les quatre choses obligatoires #

1. Un endroit où faire tourner Agora #

Choisis l'une des trois possibilités. Chacune donne le même produit.

• Docker sur un VPS (un serveur loué chez un hébergeur), un NAS (un boîtier de stockage réseau) ou une machine à toi. Il te faut Docker Engine et son extension Compose v2, et l'accès à un terminal sur cette machine, en root ou avec sudo. Pour vérifier, tape ces deux commandes : elles doivent répondre par un numéro de version, et la seconde doit annoncer la version 2 ou plus.

  Copier

  docker --version
  docker compose version

  <!-- CAPTURE C-004 -->

  Si Docker n'est pas installé, le site officiel l'explique : https://get.docker.com.

• Un panel Pterodactyl ou Pelican (le site web où l'on gère ses serveurs de jeu) sur lequel tu peux importer un œuf (un fichier qui explique au panel comment installer Agora). Il faut pour cela être administrateur du panel.

• Un serveur « Node.js » vendu par un hébergeur de jeux ordinaire, si tu n'as que le panel client de cet hébergeur : Node.js 22 ou plus récent, sur un processeur x86-64.

Les ressources à prévoir :

Sur un panel, les formulaires demandent la mémoire et le disque en Mo : 2 Go se saisissent 2048 et 10 Go 10240. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre) : avec la base intégrée, 2 Go de mémoire sont conseillés -->

<!-- CAPTURE C-006 -->

2. Une clé de licence #

La clé est lue dès le premier démarrage : sans elle, rien ne se télécharge. L'essai de 14 jours est lui aussi une clé, gratuite, à récupérer dans ton espace sur agorapanel.com. Voir L'essai gratuit de 14 jours.

3. Un accès HTTPS sortant #

Ta machine doit pouvoir joindre ces adresses sur Internet (c'est ce qu'on appelle un accès sortant : la machine appelle, personne n'a besoin de l'appeler) :

• le serveur de licences et de mises à jour : lic1.agorapanel.com et lic2.agorapanel.com ;
• agorapanel.com (amorçage et fonds de carte) ;
• discord.com (connexion des membres et bot).

Pour vérifier depuis ta machine, tape cette commande : une réponse HTTP, quelle qu'elle soit, prouve que la connexion passe.

curl -sI https://lic1.agorapanel.com/ | head -n 1

<!-- CAPTURE C-005 -->

4. Un compte Discord #

Agora n'a pas de comptes à lui : toute connexion passe par Discord. Tu crées une application Discord (un petit objet que tu déclares dans le portail des développeurs de Discord) pendant la mise en route ; l'écran te guide. Il te faut seulement un compte Discord. Voir Relier Discord.

Ce qui est facultatif #

• Un nom de domaine (une adresse comme forum.monserveur.com) : il n'est pas obligatoire. Une adresse http://IP:PORT suffit pour installer et faire tourner Agora. Prévois tout de même le HTTPS dès que le serveur sort des tests : la tablette en jeu et l'installation du site comme application en ont besoin.
• La base de ton serveur de jeu, pour le MDT : c'est la base MySQL ou MariaDB que ton serveur FiveM (ESX, QBCore ou Qbox) utilise déjà. Le forum, les candidatures et les dons fonctionnent sans ; le MDT, la carte live, la RH et la concession en ont besoin, joignable depuis la machine d'Agora. Ne la confonds pas avec la base d'Agora : voir Les deux bases d'Agora et Brancher la base de données du serveur de jeu.
• Un accès à ton serveur FiveM, pour la tablette : la clé d'API de ton panel, un accès SFTP (un transfert de fichiers sécurisé), ou simplement le gestionnaire de fichiers de ton hébergeur.

Côté joueurs #

• Un compte Discord lié à FiveM (identités Discord activées sur le serveur).
• Rien à installer : la tablette s'ouvre dans FiveM.

Tu sais que tu es prêt quand… #

• Tu sais lequel des trois endroits va faire tourner Agora, et il a la mémoire et le disque voulus.
• Tu as une clé de licence, ou tu sais où demander l'essai gratuit.
• La commande curl de la section 3 répond par une ligne qui commence par HTTP.
• Tu as un compte Discord.

Étape suivante : Ton premier jour avec Agora.

Si ça ne marche pas #

• docker compose version répond « command not found » ou une version 1 : installe Docker avec la méthode de https://get.docker.com, qui inclut Compose v2.
• La commande curl ne répond rien ou dépasse le délai : le réseau de ta machine bloque la sortie. Voir Serveur de licences ou de mises à jour injoignable.

Pour aller plus loin #

• Pas de redirection. Agora joint lic1.agorapanel.com et lic2.agorapanel.com directement et ne suit aucune redirection vers ces adresses : un proxy sortant qui redirige fait échouer l'appel.
• Espace disque. Agora garde deux versions de l'application sur le disque (la courante et la précédente), plus tes sauvegardes.
• Ports. Avec Docker, Agora écoute sur le port 3000 par défaut et publie aussi le port 40121 pour l'onglet txAdmin. Ouvre le premier au pare-feu de ta machine pour que tes visiteurs entrent ; le second seulement si tu veux utiliser txAdmin depuis un autre poste.