Operations

These runbooks tell an operator how to start, stop, release, and clean up Rhumbatron. They also tell the operator how to monitor its cost. Rhumbatron runs as one Docker Compose stack behind Caddy at https://rhumbatron.localhost (ADR 0034).

Rules

1. compose.yaml and the files under services/ define the stack. Change the stack only in these files.
2. Keep secrets in .env, apps/web/.env.local, or the Keychain. Git never tracks them (bun run check:guardrails).
3. Only the Anthropic API costs money. Keep its spend under ANTHROPIC_MONTHLY_BUDGET_USD.
4. Only executable Evidence passes a release or promotion gate. Model confidence never passes a gate.

Runbooks

Runbook	Content	Commands
Local stack	Prerequisites, start, the local CA, hostnames, logs, settings, data volumes, restarts, checks, and a Linux server.	bun run stack:up bun run stack:trust bun run stack:logs bun run stack:down bun run smoke local bun run test:ui
Cleanup and retention	Smoke Project cleanup, Project deletion, the daily fork sweep, and retention.	bun run cleanup:projects bun run cleanup:projects --dry-run
Costs and budgets	What costs money, the caps (Anthropic, Sandbox, browser checks), call quotas, and what to do when a cap trips.	/admin in the web app
Application releases	Live app releases, hosts, rollback, stuck releases, and release checks.	bun run e2e local
Resource naming	Names of services, volumes, networks, streams, and repositories.	bun run check:guardrails

Related decisions

• ADR 0010: The git service as Project source
• ADR 0011: Sandbox workspaces with a prebuilt image
• ADR 0020: Live apps on workerd with the Worker Loader
• ADR 0021: Anthropic as the model provider
• ADR 0034: One Docker Compose stack on open-source backends