/docs/self-host/deploy

Deploy

The reference deployment uses Docker Compose for local stacks and a per-service Helm chart for Kubernetes. Talk to engineering for production runbooks.

Local stack (Docker Compose)

docker compose -f docker-compose.dev.yml up --build

Kubernetes (Enterprise)

obsrv ships a Helm chart per service. The chart pins images by digest and exposes a small set of values: replica count, ingress hosts, secrets, and storage backends.

helm repo add client https://charts.obsrv.tech
helm install obsrv obsrv/obsrv -f values.prod.yaml

Database migrations

SQL migrations are vendored in the API container. The first start applies all pending migrations under an advisory lock. See Database migrations for the operational details.