Deploy with the Helm chart

The gateway chart deploys the systemprompt.io server to Kubernetes. It is published to charts.systemprompt.io and indexed on Artifact Hub, and it runs the same ghcr.io/systempromptio/systemprompt-template image that backs every other channel.

Pick Helm when you already run Kubernetes and want the gateway managed as a release, with bundled Postgres for a quick start or an external database for production.

Add the repo

helm repo add systemprompt https://charts.systemprompt.io
helm repo update

Install (single replica, embedded Postgres)

helm install gateway systemprompt/gateway \
  --set secrets.anthropicApiKey=sk-ant-... \
  --set postgresql.auth.password=<strong-pw>

This runs one gateway pod with a bundled Postgres. First boot writes a profile, waits for Postgres, runs migrations, and starts the API on port 8080.

HA install (3 replicas, external Postgres, ingress)

curl -LO https://raw.githubusercontent.com/systempromptio/systemprompt-template/main/helm/gateway/values-ha.yaml
# edit values-ha.yaml: set externalDatabase.url and ingress.hosts
helm install gateway systemprompt/gateway \
  -f values-ha.yaml \
  --set secrets.anthropicApiKey=sk-ant-...

Set postgresql.enabled=false and externalDatabase.url to point at your own database. secrets.existingSecret lets you reference an existing Secret with anthropic/openai/gemini keys instead of passing them inline.

Upgrade

helm repo update
helm upgrade gateway systemprompt/gateway --reuse-values

Where to go next

For the full value reference, signature verification with cosign, and uninstall steps, see the full Helm recipe in the template repository. For Helm itself (repos, releases, values), see the Helm documentation.