// Use when onboarding to the Local-Stack repo, locating the owning service or stack for a change, or checking Swarm migration conventions before editing infrastructure files
Use when modifying stackctl.sh and you need the repo-specific safety, portability, and validation rules for stack orchestration changes
Use when changing Python utilities under tools/ and you need the repo-specific contracts for rendering, env handling, validation, and secret-safe behavior
| name | project-local-stack-overview |
| description | Use when onboarding to the Local-Stack repo, locating the owning service or stack for a change, or checking Swarm migration conventions before editing infrastructure files |
| metadata | {"migrated-from":".github/instructions/project-context.instructions.md","source-format":".instructions.md"} |
Local-Stack is a local infrastructure repo moving from service-local Compose files to modular Docker Swarm stacks. Prefer the owning service directory for edits, then regenerate or sync derived stack output instead of patching generated files directly.
docker-compose.yml, docker-compose.yaml, swarm.fragment.yml, and .env.example.stacks/ as rendered output unless the workflow explicitly says to regenerate or sync them.traefik-public network with Traefik labels.| Area | Source of truth | Notes |
|---|---|---|
| Edge routing | traefik/ | Main reverse proxy and shared entrypoint |
| API gateway | apisix/ | Gateway, dashboard, and etcd live here |
| Databases | postgres/, mongo/, redis/ | Persistent internal services |
| Observability | observability/ | Grafana, Prometheus, Loki, Tempo, OTel |
| Platform apps | growthbook/, anitrend/, on-the-edge/, edge-graphql/, website/, beszel/ | Service-local config and fragments |
| Generated stacks | stacks/ | Do not hand-edit rendered output |
| Stack | Main contents |
|---|---|
stacks/infrastructure.yml | Traefik, Portainer, APISIX, Postgres, Mongo, Redis |
stacks/observability.yml | Prometheus, Grafana, Loki, Tempo, OTel |
stacks/platform.yml | GrowthBook and app-facing platform services |
docker swarm init
docker network create --driver=overlay --attachable traefik-public
docker stack deploy -c stacks/infrastructure.yml infrastructure
docker stack deploy -c stacks/observability.yml observability
docker stack deploy -c stacks/platform.yml platform
stacks/ directly instead of the owning service source.swarm.*.yml files for deployment.traefik-public network or required Traefik labels on exposed services..env files as guaranteed to exist instead of updating .env.example when new variables are needed.