# ByteLyst Single-VM Deployment

> Deploy the **entire ByteLyst ecosystem** (30 services, 10 products) on a single Azure VM.
> Two orchestration approaches — pick one or learn both side by side.

---

## Approaches

### [`docker/`](docker/) — Docker Compose (Production-ready)

Proven, battle-tested deployment using `docker-compose.ecosystem.yml`.
Installs everything from scratch on a raw Ubuntu VM in ~20 minutes.

```bash
sudo ./docker/setup.sh              # Full install
sudo ./docker/setup.sh --resume     # Resume after disconnect
/opt/bytelyst/check-health.sh       # Verify all 30 services
```

**Use this if:** You want reliable deployment now.

### [`k8s/`](k8s/) — Kubernetes via k3s (Learning / Future-ready)

Same 30 services orchestrated by Kubernetes on a single VM using k3s.
Builds on the same Docker images — no Dockerfile changes needed.

**Use this if:** You want to learn K8s with real services, practice `kubectl`,
and prepare for multi-node scaling later.

---

## Architecture (shared by both approaches)

```
Raw Ubuntu 24.04 VM (Standard_D8s_v5: 8 vCPU, 32 GB RAM)
├── Ollama (systemd, :11434) ─── local LLM inference
├── Gitea (Docker/:3300) ──────── npm package registry
└── 30 Services
    ├── Infrastructure (6): cosmos-emulator, azurite, mailpit, loki, grafana, traefik
    ├── Platform (3): platform-service, extraction-service, mcp-server
    ├── Dashboards (2): admin-web, tracker-web
    ├── Backends (10): peakpulse, chronomind, jarvisjr, nomgap, mindlyst,
    │                   lysnrai, notelett, flowmonk, actiontrail, localmemgpt
    └── Web Apps (9): lysnrai-dashboard, chronomind-web, jarvisjr-web, flowmonk-web,
                      notelett-web, mindlyst-web, nomgap-web, actiontrail-web, localmemgpt-web
```

## Comparison

| | Docker Compose | K8s (k3s) |
|--|----------------|-----------|
| **Setup time** | ~20 min | ~30 min |
| **RAM overhead** | ~100 MB | ~600 MB |
| **Config files** | 1 compose + 1 .env | ~30 manifests (or Helm) |
| **Scaling** | Manual | `kubectl scale` / HPA |
| **Rolling updates** | Restart-based | Zero-downtime |
| **Resource limits** | Basic | Fine-grained per pod |
| **Multi-VM ready** | Docker Swarm | Native `kubectl join` |
| **Learning value** | Low | High (transferable to AKS/EKS/GKE) |