Installer avec Docker (install.sh)

En bref. Sur une machine Linux où Docker est installé, une seule commande prépare tout : le conteneur d'Agora, sa base de données et ta clé de licence. Tu n'as aucune base de données à créer : le script la fournit et choisit son mot de passe. Agora se télécharge au premier démarrage, puis tu termines dans le navigateur.

Avant de commencer #

• Une machine Linux que tu administres : un VPS (un serveur loué chez un hébergeur), un NAS (un boîtier de stockage réseau) ou un ordinateur dédié. Si tu hésites entre cette voie, un panel ou un serveur Node.js, lis Choisir entre Docker, l'œuf de panel et un serveur Node.js.

• Docker et son plugin Compose version 2 (la commande s'écrit docker compose, avec une espace et sans tiret). Pour le vérifier, tape docker --version puis docker compose version : les deux doivent répondre un numéro de version. Il manque Docker ? Le script d'installation officiel est expliqué sur https://get.docker.com. Les deux mots sont définis dans le glossaire.

  <!-- CAPTURE C-004 -->

• Les droits d'administrateur : connecte-toi en root, ou fais précéder la commande de sudo.

• Ta clé de licence (elle commence par AGORA-). Elle est sur la page Installer sur mon panel de ton espace sur agorapanel.com (Mon espace → Installer sur mon panel), malgré le nom de la page : c'est là que se trouvent aussi tes fichiers Docker. Pas de clé encore ? Clique sur Obtenir ma clé d'essai gratuite : voir L'essai gratuit de 14 jours.

• Une sortie vers Internet en HTTPS depuis la machine (la liste complète est dans Prérequis).

Étapes #

1. Connecte-toi à ta machine en SSH (une connexion sécurisée au terminal de la machine). Depuis Windows 10 ou 11, ouvre PowerShell et tape ssh root@ADRESSE-DE-TA-MACHINE; ton hébergeur te donne l'adresse et l'identifiant. Tu vois alors l'invite de la machine (root@…).

   <!-- CAPTURE C-030 -->

2. Lance l'installation. Colle cette commande en remplaçant la clé par la tienne :

   Copier

   curl -fsSL https://agorapanel.com/install.sh | sh -s -- AGORA-XXXXX-XXXXX-XXXXX-XXXXX

   Le script affiche ses étapes (▸ Installation dans /opt/agora, ▸ Démarrage…) et rend la main en quelques secondes.

   <!-- CAPTURE C-031 -->

3. Vérifie que les deux conteneurs tournent.

   Copier

   docker ps

   Tu dois voir deux lignes, agora et agora-db, avec l'état Up.

   <!-- CAPTURE C-032 -->

4. Suis le premier démarrage. Au tout premier lancement, Agora se télécharge, ce qui prend quelques minutes :

   Copier

   docker logs -f agora

   Pour quitter le suivi sans arrêter Agora, tape Ctrl+C. Attends la ligne ✓ Ready in ….

   <!-- CAPTURE C-033 -->

5. Ouvre le site. Dans ton navigateur, va à http://ADRESSE-DE-TA-MACHINE:3000. Si la page ne s'ouvre pas depuis un autre ordinateur, ouvre le port 3000 dans le pare-feu de ton hébergeur (le pare-feu est le filtre qui autorise ou bloque les ports : voir Prérequis).

   <!-- CAPTURE C-036 -->

6. Fais la mise en route. L'écran qui s'affiche te guide en trois étapes : voir Premier démarrage et mise en route.

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

• docker ps liste agora et agora-db à l'état Up.
• La console affiche ✓ Ready in ….
• Ton navigateur affiche l'écran Mise en route, ou l'adresse http://ADRESSE-DE-TA-MACHINE:3000/api/health répond "ok": true.

Si ça ne marche pas #

Pour aller plus loin #

Ce que fait le script #

L'application ne tourne jamais en root dans le conteneur : elle tourne sous l'utilisateur 1000, sans aucune capacité Linux. Le script est public et ne contient aucun code produit : c'est l'amorçage boot.mjs qui télécharge Agora, en vérifiant la signature et l'empreinte (le résumé court qui prouve qu'un fichier n'a pas été modifié).

Relancer le script #

Relancer la même commande est sans danger : ton .env et tes volumes sont conservés. L'amorçage et le compose sont remis à jour. Une clé passée en argument est ignorée si un .env existe déjà (le script le dit : « Clé passée en argument IGNORÉE ») : change AGORA_KEY dans /opt/agora/.env, puis docker compose up -d. De même, le port annoncé à la fin est toujours celui du .env en place : si tu passes un AGORA_PORT différent, il est ignoré et le script te le dit ; pour changer de port, modifie AGORA_PORT dans le .env. Les téléchargements du script ont un délai et deux reprises : une connexion qui se fige ne laisse plus l'installation pendue.

Le port ouvert directement sur Internet #

Une installation neuve écrit AGORA_TRUSTED_PROXIES=none dans .env : aucun visiteur ne peut choisir son adresse IP pour contourner les limites de débit. Si tu places ensuite un reverse proxy sur la même machine, lis Derrière un proxy.

Schéma des dossiers #

<!-- CAPTURE C-034 -->

Variante : le compose à la main #

Tu préfères poser les fichiers toi-même ?

1. Dans la page Installer sur mon panel, clique sur Télécharger mon .env (Docker Compose) : ta clé et des secrets tirés au sort y sont déjà. Comme le fichier contient ta clé, le site demande d'abord de vérifier ta session (voir Activer ou changer de clé).

   <!-- CAPTURE C-035 -->

2. Récupère le fichier docker-compose.yml d'Agora. <!-- À CONFIRMER : DOC-4, aucun lien public vers le docker-compose.yml manuel (absent de public/ du site) ; le compose.yml écrit par install.sh en tient lieu -->

3. Dans le même dossier, télécharge l'amorçage : curl -fsSL https://agorapanel.com/boot.mjs -o boot.mjs

4. Lance docker compose up -d.

Ne mélange pas les deux voies. Le .env téléchargé sur le site (variante ci-dessus) va avec le compose à la main ; install.sh, lui, écrit son propre .env et son propre compose. Poser le .env du site dans /opt/agora avant de lancer install.sh donne une clé vide et un message de l'amorçage qui cite AGORA_LICENSE_KEY. Choisis l'une ou l'autre.

Ce compose propose aussi un profil Caddy pour le HTTPS automatique (voir Derrière un proxy). Dans ce cas, la clé s'appelle AGORA_LICENSE_KEY dans le .env : voir Les variables d'environnement.