Skip to content
GOVERN Admin

Container Setup

The container setup gives you full control over where GOVERN runs. Use it when you need data residency guarantees, private networking, or custom infrastructure.

Docker Compose (development / small deployments)

govern-docker-compose.yml
version: '3.8'
services:
  govern-api:
    image: archetypal/govern-api:latest
    environment:
      - GOVERN_DB_URL=postgresql://govern:secret@db:5432/govern
      - GOVERN_REDIS_URL=redis://redis:6379
      - GOVERN_LICENSE_KEY=${GOVERN_LICENSE_KEY}
    ports:
      - "8443:8443"
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: govern
      POSTGRES_USER: govern
      POSTGRES_PASSWORD: secret
    volumes:
      - govern-db:/var/lib/postgresql/data
  redis:
    image: redis:7-alpine
    volumes:
      - govern-redis:/data
volumes:
  govern-db:
  govern-redis:
Terminal window
docker compose -f govern-docker-compose.yml up -d

Kubernetes (production deployments)

Helm chart:

Terminal window
helm repo add archetypal https://charts.archetypal.ai
helm repo update
helm install govern archetypal/govern \
  --set api.licenseKey=$GOVERN_LICENSE_KEY \
  --set database.url=$GOVERN_DB_URL \
  --set ingress.host=govern.yourcompany.com

Health checks

Terminal window
curl https://your-govern-instance/health
curl https://your-govern-instance/health/ready
curl https://your-govern-instance/health/live

Upgrading

Terminal window
docker compose pull && docker compose up -d
# or
helm upgrade govern archetypal/govern --reuse-values