Rowkai

Rowkai Docs

Kubernetes deployment guide.

Kubernetes

Deploy Rowkai with Kustomize, object storage, and optional GraphQL ingress.

Run Rowkai as a real tenant platform on Kubernetes, with the control plane, Pageserver, WAL service, and compute orchestration managed as one system.

Deployment flow

  1. Create the namespace and S3 credentials secret.
  2. Build and push the PostgreSQL and Go service images.
  3. Update image references in Kustomize.
  4. Apply the manifests.

Apply manifests

kubectl apply -k deploy/k8s/

Optional GraphQL ingress

--k8s-graphql-ingress-base-domain=gql.rowkai.example.com
--k8s-graphql-ingress-class=nginx
--k8s-graphql-cluster-issuer=letsencrypt-prod
--k8s-graphql-external-dns-target=<your-ingress-lb-hostname>
--k8s-graphql-cloudflare-proxied=true

Important note

Standard Kubernetes Ingress is for HTTP and HTTPS endpoints like the control plane and GraphQL. PostgreSQL TCP traffic should use a LoadBalancer, Cloudflare Tunnel, or another TCP-capable edge strategy.