7.7 KiB
7.7 KiB
Ecosystem Deployment Guide
File:
docker-compose.ecosystem.ymlPurpose: Run the entire ByteLyst ecosystem in a single Docker Compose stack.
Prerequisites
- Docker Desktop with Compose v2+
- All product repos cloned as siblings of
learning_ai_common_plat:
~/code/mygh/
├── learning_ai_common_plat/ # This repo
├── learning_voice_ai_agent/ # LysnrAI
├── learning_multimodal_memory_agents/ # MindLyst
├── learning_ai_clock/ # ChronoMind
├── learning_ai_jarvis_jr/ # JarvisJr
├── learning_ai_fastgap/ # NomGap
├── learning_ai_peakpulse/ # PeakPulse
├── learning_ai_flowmonk/ # FlowMonk
├── learning_ai_notes/ # NoteLett
├── learning_ai_trails/ # ActionTrail
└── learning_ai_local_memory_gpt/ # LocalMemGPT
@bytelyst/*packages built (for platform-service / extraction-service):
cd learning_ai_common_plat
pnpm -r --filter './packages/*' build
Quick Start
cd learning_ai_common_plat
# 1. Create env file from example
cp .env.ecosystem.example .env.ecosystem
# Edit .env.ecosystem — fill in Stripe keys, Gemini key, etc.
# 2. Validate compose config
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem config --quiet
# 3. Build and start everything
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up --build -d
# 4. Check health
docker compose -f docker-compose.ecosystem.yml ps
Port Map
Infrastructure
| Service | Port | URL |
|---|---|---|
| Cosmos DB Emulator | 8081 | http://localhost:8081 |
| Cosmos Data Explorer | 1234 | http://localhost:1234 |
| Azurite (Blob) | 10000 | http://localhost:10000 |
| Mailpit SMTP | 1025 | — |
| Mailpit UI | 8025 | http://localhost:8025 |
| Loki | 3100 | http://localhost:3100 |
| Grafana | 3000 | http://localhost:3000 |
| Traefik Dashboard | 8080 | http://localhost:8080 |
Platform Services
| Service | Port | URL |
|---|---|---|
| platform-service | 4003 | http://localhost:4003/health |
| extraction-service | 4005 | http://localhost:4005/health |
| mcp-server | 4007 | http://localhost:4007/health |
Platform Dashboards
| Dashboard | Port | URL |
|---|---|---|
| Admin Console | 3001 | http://localhost:3001 |
| Issue Tracker | 3003 | http://localhost:3003 |
Product Backends
| Product | Port | URL |
|---|---|---|
| PeakPulse | 4010 | http://localhost:4010/health |
| ChronoMind | 4011 | http://localhost:4011/health |
| JarvisJr | 4012 | http://localhost:4012/health |
| NomGap | 4013 | http://localhost:4013/health |
| MindLyst | 4014 | http://localhost:4014/health |
| LysnrAI | 4015 | http://localhost:4015/health |
| NoteLett | 4016 | http://localhost:4016/health |
| FlowMonk | 4017 | http://localhost:4017/health |
| ActionTrail | 4018 | http://localhost:4018/health |
| LocalMemGPT | 4019 | http://localhost:4019/health |
Product Web Apps
| Product | Port | URL |
|---|---|---|
| LysnrAI Dashboard | 3002 | http://localhost:3002 |
| ChronoMind | 3030 | http://localhost:3030 |
| JarvisJr | 3035 | http://localhost:3035 |
| FlowMonk | 3040 | http://localhost:3040 |
| NoteLett | 3045 | http://localhost:3045 |
| MindLyst | 3050 | http://localhost:3050 |
| NomGap | 3055 | http://localhost:3055 |
| ActionTrail | 3060 | http://localhost:3060 |
| LocalMemGPT | 3070 | http://localhost:3070 |
Selective Startup
You don't need to run everything. Use Docker Compose profiles or just name services:
# Infrastructure + platform only
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
cosmos-emulator azurite mailpit loki grafana gateway \
platform-service extraction-service mcp-server \
admin-web tracker-web
# Infrastructure + platform + one product
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
cosmos-emulator azurite mailpit platform-service \
flowmonk-backend flowmonk-web
# Just backends (no web apps)
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
cosmos-emulator azurite mailpit platform-service extraction-service \
flowmonk-backend notelett-backend actiontrail-backend
Teardown
# Stop all
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem down
# Stop and remove volumes (clean slate)
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem down -v
Troubleshooting
Cosmos emulator slow to start
The emulator needs 20-30s on first boot. Other services wait via depends_on: condition: service_healthy.
Port conflicts
If a port is already in use (e.g., Grafana on 3000), either stop the conflicting process or override the host port:
# Override in .env.ecosystem or via CLI
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
-e GRAFANA_PORT=3099
LocalMemGPT needs Ollama
LocalMemGPT connects to Ollama on the host via host.docker.internal:11434. Make sure Ollama is running locally.
Build failures for product repos
Product Dockerfiles use the Gitea npm registry for @bytelyst/* packages. If building on a fresh machine, ensure:
GITEA_NPM_TOKENis set in your environment- Gitea is running at
localhost:3300 - All 49
@bytelyst/*packages are published
See docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md for details.
Architecture
┌─────────────────────────────────────────────────────────────┐
│ Traefik Gateway (:80) │
└──────┬──────────────┬──────────────┬────────────────────────┘
│ │ │
┌────▼────┐ ┌─────▼─────┐ ┌────▼────┐
│Platform │ │Extraction │ │ MCP │
│ :4003 │ │ :4005 │ │ :4007 │
└────┬────┘ └───────────┘ └─────────┘
│
┌────▼────────────────────────────────────────────────┐
│ 10 Product Backends │
│ :4010-4019 (PeakPulse…LocalMemGPT) │
└────┬────────────────────────────────────────────────┘
│
┌────▼────────────────────────────────────────────────┐
│ 9 Product Web Apps │
│ :3002, :3030-3070 │
└─────────────────────────────────────────────────────┘
│
┌────▼────────────────────────────────────────────────┐
│ Infrastructure │
│ Cosmos :8081 Azurite :10000 Mailpit :1025/8025 │
│ Loki :3100 Grafana :3000 │
└─────────────────────────────────────────────────────┘