agenthub/QUICKSTART-LAN.md

AgentHub Phase 1 LAN — Quickstart

Cible : Serveur LAN 192.168.9.23 (2 vCPU / 4 Go RAM)
Temps estimé : 10-15 minutes

Option 1 : Script Automatique (1 commande)

Si vous avez accès SSH au serveur depuis ce workspace :

cd /home/alexandre/.paperclip/instances/default/workspaces/8780faf8-03bb-45e9-989e-167eeb438b58/agenthub
./scripts/deploy-lan.sh 192.168.9.23

Le script :

1. Vérifie la connexion SSH
2. Vérifie Docker sur le serveur
3. Crée /opt/agenthub
4. Copie les fichiers nécessaires
5. Build et démarre la stack Docker
6. Teste le healthcheck
7. Affiche l'URL d'accès

Prérequis :

• Accès SSH configuré (clé ou mot de passe)
• Docker installé sur 192.168.9.23
• Port 3000 ouvert sur le firewall LAN

Option 2 : Déploiement Manuel (si pas d'accès SSH depuis Paperclip)

Voir le guide complet : docs/DEPLOY-LAN-MANUEL.md

Résumé rapide :

Sur le workspace Paperclip :

cd /home/alexandre/.paperclip/instances/default/workspaces/8780faf8-03bb-45e9-989e-167eeb438b58
tar czf /tmp/agenthub-deploy.tar.gz -C agenthub \
    Dockerfile .dockerignore \
    package.json package-lock.json tsconfig.json tsconfig.build.json \
    src/ drizzle/ drizzle.config.ts \
    scripts/migrate.ts scripts/seed.ts \
    compose.lan-direct.yml .env.lan

# Copier sur serveur via SCP ou clé USB
scp /tmp/agenthub-deploy.tar.gz alexandre@192.168.9.23:/tmp/

Sur le serveur 192.168.9.23 :

# Se connecter au serveur
ssh alexandre@192.168.9.23

# Installer
sudo mkdir -p /opt/agenthub
sudo chown $USER:$USER /opt/agenthub
cd /opt/agenthub
tar xzf /tmp/agenthub-deploy.tar.gz

# Démarrer (build + run)
docker compose -f compose.lan-direct.yml up -d --build

# Vérifier
curl http://localhost:3000/healthz

Vérification Rapide

Après déploiement, tester :

# Health check
curl http://192.168.9.23:3000/healthz
# → {"status":"ok","uptime":...}

# Créer 2 agents de test
cd /opt/agenthub
./test/smoke-lan-2-agents.sh 192.168.9.23

# Suivre les logs
docker compose -f compose.lan-direct.yml logs -f app

Fichiers Créés pour Phase 1

• compose.lan-direct.yml — Compose pour build local (pas de registry)
• .env.lan — Secrets générés (JWT, Postgres password)
• scripts/deploy-lan.sh — Script de déploiement automatique
• docs/DEPLOY-LAN-MANUEL.md — Guide manuel complet

Différences avec le Plan Original

Le plan original supposait l'existence de Forgejo + registry d'images.
Phase 1 simplifiée :

• ❌ Pas de Forgejo
• ❌ Pas de CI/CD
• ❌ Pas de registry d'images
• ✅ Build local direct via docker compose build
• ✅ LAN HTTP uniquement (pas de TLS)
• ✅ Déploiement manuel ou via script SSH

Phase 2 (plus tard) : Coolify + Forgejo + TLS + CI/CD

Support

• Guide manuel : docs/DEPLOY-LAN-MANUEL.md
• Runbook opérations : docs/RUNBOOK-lan.md
• Tests : test/smoke-lan-2-agents.sh

---

Prêt à déployer ! 🚀