Deployment

Fly.io (cloud demo)

Single monolith with supervisord managing 30+ services.

flyctl deploy --dockerfile Dockerfile.fly --remote-only \
  --build-arg VITE_COMMIT_SHA=$(git rev-parse --short HEAD) \
  --build-arg VITE_BUILD_DATE=$(date -u +%Y-%m-%d)

The CI workflow auto-deploys on push to main with:

• 3-attempt retry on flyctl deploy
• Version verification (accepts any of the last 5 commit SHAs)
• Smoke tests against the live deployment
• Concurrency control (one deploy at a time)

Homelab (self-hosted)

Docker Compose with per-service containers, Traefik reverse proxy, and Watchtower auto-updates.

• Stack: /opt/stacks/veta/compose.yml
• Image: ghcr.io/milesburton/veta-trading-platform:latest
• Watchtower polls GHCR every 5 minutes

Local development

# Start all services
supervisorctl start all

# Frontend dev server
cd frontend && npm run dev

# Electron
cd frontend && npm run electron:dev

Environment variables

Variable	Default	Purpose
DATABASE_URL	(required)	PostgreSQL connection string
OAUTH2_SHARED_SECRET	veta-dev-passcode	Demo login passcode
RISK_ENGINE_ENABLED	true	Enable/disable pre-trade risk checks
VETA_DEMO_MODE	true	Show demo personas on login page
JOURNAL_RETENTION_DAYS	90 (local) / 1 (Fly.io)	Event retention period
LLM_ENABLED	false	Enable Ollama LLM advisory