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

​
Prerequisites

  • An EKS cluster (eksctl quickstart)
  • kubectl configured for the cluster
  • helm v3+
  • An RDS PostgreSQL instance

​
Create an RDS database

In the AWS Console → RDS → Create database:
  • Engine: PostgreSQL
  • Template: Production (or Dev/Test for smaller deployments)
  • Instance class: db.t4g.medium is a good starting point
  • Place in the same VPC as your EKS cluster
Note the endpoint, username, and password.

​
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-rds-endpoint:5432/oxy" \
  --from-literal=OPENAI_API_KEY="sk-..."
Create values.yaml: 
envFrom:
  - secretRef:
      name: oxy-secrets

ingress:
  enabled: true
  className: alb
  annotations:
    kubernetes.io/ingress.class: alb
    alb.ingress.kubernetes.io/scheme: internet-facing
    alb.ingress.kubernetes.io/target-type: ip
  hosts:
    - host: oxy.example.com
      paths:
        - path: /
          pathType: Prefix
Install: 
helm install oxy oxy/oxy -f values.yaml

​
Upgrade

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

​
Next steps