Skip to main content
Before going to production, work through this checklist.

​
Infrastructure

  • Kubernetes cluster with at least 2 nodes
  • Managed PostgreSQL (RDS, Cloud SQL, Supabase, or equivalent) with automated backups
  • Persistent volume or object storage for workspace data
  • Domain name and TLS certificate (cert-manager works well)

​
Oxy configuration

  • OXY_DATABASE_URL pointing to your managed PostgreSQL
  • At least one LLM provider key set (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)
  • Authentication configured — see Environment reference
  • MAGIC_LINK_SECRET or OAuth provider set up for user login

​
For multi-workspace (cloud) mode

  • GitHub App created and configured — see GitHub App Setup
  • GITHUB_APP_ID, GITHUB_APP_SLUG, GITHUB_APP_PRIVATE_KEY set
  • GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET set
  • GITHUB_STATE_SECRET set to a stable random value

​
Networking

  • Ingress controller installed (nginx, ALB, Traefik, etc.)
  • TLS termination configured
  • OXY_API_URL set if the backend is behind a different hostname than the frontend

​
Operations

  • Resource limits set in values.yaml
  • Liveness and readiness probes confirmed healthy
  • Log aggregation in place (CloudWatch, Datadog, Loki, etc.)
  • Alerts on pod restarts and database connection failures

​
Deploy

helm repo add oxy https://oxy-hq.github.io/charts
helm repo update
helm install oxy oxy/oxy -f values.yaml
See github.com/oxy-hq/charts for the full values reference.