# 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 :

```bash
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](docs/DEPLOY-LAN-MANUEL.md)**

### Résumé rapide :

**Sur le workspace Paperclip :**

```bash
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 :**

```bash
# 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 :

```bash
# 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](docs/DEPLOY-LAN-MANUEL.md)
- **Runbook opérations :** [docs/RUNBOOK-lan.md](docs/RUNBOOK-lan.md)
- **Tests :** `test/smoke-lan-2-agents.sh`

---

**Prêt à déployer !** 🚀