Deployment

Helm (Kubernetes)

A chart lives in charts/terraplane. It runs one orchestrator and N agents, expects an external database, and consumes existing Kubernetes Secrets.

helm install terraplane oci://ghcr.io/terraplane-org/charts/terraplane \
  --version 0.1.2 \
  -n terraplane --create-namespace \
  -f my-values.yaml

Typical production layout is two releases:

1. Orchestrator — reachable for GitHub webhooks
2. Agents — orchestrator.enabled=false plus agentDefaults.orchestratorURL

See the chart README for values, secrets examples, and split-install notes.

Binary downloads ship on GitHub Releases. How to cut a product release: docs/release.md in the product repo.

Docker Compose

For local/dev, Docker Compose remains the quickest path (Postgres + migrate + orchestrator + agents). See the Quickstart.