Helm

Deploy runtz on a Kubernetes cluster with the official chart.

Requirements

• A Kubernetes cluster.
• Helm 3.

Install

Add the runtz chart repository and update it:

helm repo add runtz https://helm.runtz.dev
helm repo update

Install the platform — no secrets are required, since the engine issues and stores its own sessions, API keys and login codes:

helm upgrade --install runtz runtz/runtz \
  --namespace runtz \
  --create-namespace

Optional integrations (OAuth, email login, Stripe) do take secrets. Put them in a values.secrets.yaml, keep it out of git, and pass it with -f — or point backend.secrets.existingSecret at a pre-created Kubernetes Secret.

Without an ingress (ingress.enabled=false, the default), reach the platform with a port-forward:

kubectl port-forward svc/runtz-frontend 3000:3000 -n runtz

First access

On the first access, runtz asks for:

• Admin username
• Password
• Workspace Name

After this setup, the admin user can create workspaces and manage users in Settings.

Configuration

The chart deploys the engine, the frontend and an optional in-cluster MongoDB (mongodb.enabled=true by default; set backend.env.MONGODB_URI to use an external database). Image tags default to the chart appVersion.

The chart exposes the same environment variables as the Docker Compose install. See Environment variables for the full list, and Pro and Enterprise activation for licensing.