Skip to main content
Deploy Oxy on GKE using the official Helm chart. This pairs well with Cloud SQL for PostgreSQL as the managed database.

Prerequisites

  • A GKE cluster (GKE quickstart)
  • kubectl configured for the cluster (gcloud container clusters get-credentials)
  • helm v3+
  • A Cloud SQL PostgreSQL instance

Create a Cloud SQL database

In the GCP Console → Cloud SQLCreate instancePostgreSQL:
  • Choose a region close to your GKE cluster
  • Machine type: db-g1-small or larger
  • Enable the Cloud SQL Admin API if prompted
Note the connection string: postgresql://user:password@IP:5432/oxy

Install Oxy

helm repo add oxy https://oxy-hq.github.io/charts
helm repo update
Store your credentials as a Kubernetes Secret:
kubectl create secret generic oxy-secrets \
  --from-literal=OXY_DATABASE_URL="postgresql://user:password@your-cloudsql-ip:5432/oxy" \
  --from-literal=OPENAI_API_KEY="sk-..."
Create values.yaml:
envFrom:
  - secretRef:
      name: oxy-secrets

ingress:
  enabled: true
  className: gce
  annotations:
    kubernetes.io/ingress.class: gce
  hosts:
    - host: oxy.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: oxy-tls
      hosts:
        - oxy.example.com
Install:
helm install oxy oxy/oxy -f values.yaml

Upgrade

helm repo update
helm upgrade oxy oxy/oxy -f values.yaml

Next steps