Installation d'Argos avec Docker Compose

Installation de la pile complète sur un serveur : Argos (API, workers, dashboard), Odin et Zeus, PostgreSQL, Redis et un stockage S3 local (MinIO).

📑 Table des matières

• Prérequis
• Installation
• Exposition en HTTPS
• Vérification
• Opérations courantes

Prérequis

• Linux x86_64 ou arm64, 4 vCPU et 16 Go de RAM minimum, disque dimensionné selon le volume à indexer.
• Docker Engine 24+ et Docker Compose v2.23+ (docker compose version).
• Identifiants du registre registry.devana.ai, fournis par Devana.
• Un client OAuth sur votre plateforme Devana (voir Configuration).
• Accès réseau aux serveurs SharePoint (et au contrôleur de domaine pour Kerberos).

Installation

1. Récupérer les fichiers

Créez un répertoire d'installation et copiez-y :

• docker-compose.yml
• env.example, à renommer en .env

mkdir -p /opt/argos && cd /opt/argos
# copier docker-compose.yml et env.example dans ce répertoire
cp env.example .env && chmod 600 .env

2. Renseigner la configuration

Éditez .env :

⚠️ Sauvegardez ENCRYPTION_KEY : sans elle, les secrets enregistrés dans Argos (mots de passe SharePoint, keytabs, clés LLM) sont illisibles.

Les autres variables (versions des images, ports) sont décrites dans env.example. La liste complète figure dans Configuration.

3. Démarrer

docker login registry.devana.ai
docker compose up -d --wait

Au premier démarrage :

1. la base est créée (bases argos et odin, extensions vector et pg_trgm) ;
2. le bucket est créé et les migrations sont appliquées ;
3. l'API, les workers, le dashboard, Odin et Zeus démarrent.

--wait rend la main quand tous les services sont sains, en 1 à 2 minutes.

4. Première connexion

Ouvrez PUBLIC_URL et cliquez sur Se connecter avec Devana. Le premier utilisateur connecté devient administrateur. Pour désigner d'autres administrateurs, utilisez BOOTSTRAP_ADMIN_EMAILS ou Paramètres › Utilisateurs.

Ensuite :

1. Paramètres › Modèles (LLM) : ajoutez votre fournisseur et affectez les rôles (graphe, embeddings, vision).
2. Connexions SharePoint › Nouvelle connexion : voir Connexions SharePoint.
3. Banc de test MCP › Connecter une application : créez une clé API et configurez vos agents (voir Serveur MCP).

Exposition en HTTPS

Le dashboard écoute sur le port 3100 (FRONT_PORT). Il relaie aussi l'API et le serveur MCP (/graphql, /auth, /files, /mcp). Placez-le derrière votre reverse proxy HTTPS et renseignez PUBLIC_URL avec l'URL publique.

Exemple NGINX :

server {
    listen 443 ssl;
    server_name argos.example.com;
    # ssl_certificate / ssl_certificate_key …

    client_max_body_size 20m;          # keytabs et certificats téléversés

    location / {
        proxy_pass http://127.0.0.1:3100;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 300s;
    }

    # Serveur MCP : une lecture peut attendre l'extraction d'un document (jusqu'à 15 min)
    location /mcp {
        proxy_pass http://127.0.0.1:3100;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_read_timeout 960s;
        proxy_send_timeout 960s;
    }
}

Les ports d'administration (API 4000, PostgreSQL 5432, console MinIO 9001) ne sont publiés que sur PUBLISH_ADDR (127.0.0.1 par défaut).

Vérification

docker compose ps                                                     # tous les services « healthy » (migrate et minio-init : exited 0)
curl -s localhost:4000/readyz                                         # {"ok":true,"database":true,"redis":true}
curl -s -o /dev/null -w '%{http_code}\n' localhost:3100/healthz        # 200
curl -s -o /dev/null -w '%{http_code}\n' -X POST localhost:3100/mcp    # 401 (clé API requise)
docker compose logs zeus | grep "BullMQ worker ready"                  # Zeus prêt

Le dashboard affiche l'état des services dans Paramètres › Système (base, Redis, stockage, Odin).

Opérations courantes

docker compose logs -f serveur-worker               # journaux des traitements
docker compose up -d --scale serveur-worker=4       # workers supplémentaires
docker compose pull && docker compose up -d --wait  # mise à jour (voir Exploitation)
docker compose down                                 # arrêt (les volumes sont conservés)

Données persistantes : volumes argos_postgres-data, argos_minio-data, argos_redis-data. Pour les sauvegardes, voir Exploitation.

Pour utiliser un PostgreSQL ou un stockage S3 existant, adaptez les variables de connexion (voir Configuration) et retirez les services correspondants du fichier compose.