Skip to main content

Documentation Index

Fetch the complete documentation index at: https://oxy.tech/docs/llms.txt

Use this file to discover all available pages before exploring further.

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