Guide
The Snap CD components ship as Docker images and as zipped binaries published on GitHub Releases. The day-to-day “what files do I write, what manifests do I apply” details live in standalone reference-deployment repositories — one per substrate, each covering all three components (Server, Runner, Agent) in a single, modular layout.
Reference deployment repositories
Each of the repositories below contains a components/ directory with one self-contained sub-deployment per component. You can bring up all three together, or just the component you care about (the Runner against Cloud, an Agent attached to a remote Server, etc.). Each repo’s README walks through both shapes.
| Substrate | Reference repository |
|---|---|
| Docker / Compose | schrieksoft/snapcd-deployment-docker |
| Kubernetes (Helm or Kustomize) | schrieksoft/snapcd-deployment-kubernetes |
Each repo tracks the matching Snap CD release. The sections below give you a sense of the minimum shape per component so you know what you’re looking at when you open one of the reference repos.
Kubernetes with Helm
Each release of the Kubernetes repository publishes Helm charts to oci://ghcr.io/schrieksoft/charts, signed with cosign:
| Chart | Installs |
|---|---|
snapcd | The Server, a Runner and optionally the Agent, in one namespace and already connected to each other |
snapcd-server | The Server, with SQL Server and Redis bundled for trials |
snapcd-runner | A Runner |
snapcd-agent | The Agent and its Claude Sidecar |
helm install snapcd oci://ghcr.io/schrieksoft/charts/snapcd --namespace snapcd --create-namespace
kubectl -n snapcd port-forward svc/snapcd-server 5000:5000That gives you the Dashboard at http://localhost:5000 and a Runner that’s already connected, with the same sample settings as the Docker reference deployment. Those settings are public, so replace the keys, passwords and credentials before the Server holds anything that matters. Beyond a trial, turn off the bundled SQL Server and Redis and use managed ones instead, with server.database.* and server.cache.*.
A chart’s version is the Kubernetes repository’s release, and its app version is the Snap CD release it installs. Each chart’s README, under charts/ in the repository, lists every value. The repository’s Kustomize manifests are generated from the same charts, so the two can’t drift apart.
For a Runner that connects to Snap CD Cloud, or to a Server you don’t host, install the snapcd-runner chart on its own: put your Runner’s settings in config.appsettings and its client secret in credentials.
Server
The Server is deployed only when running Self-Hosted; Cloud users do not deploy the Server themselves.
Minimum Compose shape:
services:
snapcd-server:
image: ghcr.io/schrieksoft/snapcd/snapcd-server:latest
ports:
- "5000:5000"
environment:
- ConnectionString=Server=sqlserver,1433;Database=SnapCd;User Id=sa;Password=...;TrustServerCertificate=True
- AllowHttp=false
volumes:
- ./appsettings.External.json:/app/appsettings.External.json:roThe Server is stateless; all durable state lives in SQL Server. On Kubernetes the recommended pattern is a single Deployment behind a TLS-terminating Ingress. Database schema migrations apply automatically on startup.
Runner
A Runner is the process described on the Runner page — it picks up Jobs from the Server and executes them.
Minimum Compose shape:
services:
snapcd-runner:
image: ghcr.io/schrieksoft/snapcd/snapcd-runner-azure:latest
environment:
- Server__Url=https://snapcd.example.com
- Runner__Id=10000000-0000-0000-0000-000000000000
- Runner__OrganizationId=10000000-0000-0000-0000-000000000000
- Runner__Instance=runner-1
- Runner__Credentials__ClientId=<sp-client-id>
- Runner__Credentials__ClientSecret=<sp-client-secret>
volumes:
- runner-data:/app/runnerdataOn Kubernetes the recommended pattern is a StatefulSet: the working-directory volume persists per Pod, and if the Runner record’s allow_multiple_instances is set you can scale replicas horizontally. The Runner image comes with OpenTofu and Terraform. To use other versions, set engines.download in the Helm chart and the Pod downloads them when it starts.
Agent
An Agent runs alongside one or more Sidecars. The Agent supervises Sidecars over localhost HTTP, so they must run on the same Docker network — or, on Kubernetes, in the same namespace.
Minimum Compose shape — Agent process plus a Claude Sidecar sibling:
services:
snapcd-agent:
image: ghcr.io/schrieksoft/snapcd/snapcd-agent:latest
environment:
- Server__Url=https://snapcd.example.com
- Agent__AgentId=20000000-0000-0000-0000-000000000000
- Agent__OrganizationId=10000000-0000-0000-0000-000000000000
- Agent__InstanceName=agent-1
- Agent__ClientId=<sp-client-id>
- Agent__ClientSecret=<sp-client-secret>
- Agent__Sidecars__0__Name=claude
- Agent__Sidecars__0__BaseUrl=http://snapcd-agent-sidecar-claude:7001
depends_on:
- snapcd-agent-sidecar-claude
snapcd-agent-sidecar-claude:
image: ghcr.io/schrieksoft/snapcd/snapcd-agent-sidecar-claude:latest
environment:
- ANTHROPIC_API_KEY=<your-anthropic-key>
- SNAPCD_SERVER_URL=https://snapcd.example.comOn Kubernetes the recommended pattern is a Deployment per process (orchestrator + one per sidecar), with the sidecars exposed as ClusterIP Services so the orchestrator can reach them by name.