Helm values
Every value of the GoRunner Helm chart, with its default.
This page is for self-hosted installations. On GoRunner Cloud, GoRunner runs this for you.
Set them in your values file, or with --set. helm install and helm upgrade check them first, and say in one sentence what is wrong. To see them with their comments:
helm show values oci://ghcr.io/ralve-org/charts/gorunner --version 2026.10.30Below, <release> is the name the chart gives its objects: gorunner for a release named gorunner, so gorunner-api. A setting with a value of its own here, such as worker.concurrency, is refused under config.
| Name | Default | What it does |
|---|---|---|
| The image5 | ||
ghcr. | Where the image comes from. Change it for a mirror inside your company. | |
| the chart’s release | The version to run. Leave it empty: each chart version runs its own release. | |
| — |
| |
IfNotPresent | When the cluster downloads the image again. | |
[] | The Secret with the registry’s user name and token, such as | |
| Where people reach it10 | ||
| from ingress.host | The address people open. Every email, approval page and OAuth redirect is built from it. Empty: | |
true | Make an Ingress. Off: route to the | |
nginx | The IngressClass, such as | |
| — | The domain name. Required with an Ingress. | |
/ | GoRunner needs the whole host; a sub-path isn’t supported. With | |
false | Serve the address over https. Turn it on unless something in front ends https. | |
| <release>-tls | The certificate’s Secret, or the one cert-manager writes. | |
{} | Your own, such as | |
true | With | |
| — | Who may name the caller’s address. Empty trusts every private address, safe only while the network policy is on. MoreWith | |
| The first admin and sign-in4 | ||
| — | Only this address can make the first account. Optional without | |
false | With More
| |
false |
| |
selfhosted | Leave it. | |
| Secrets5 | ||
| — | Your own Secret, its keys the setting names. Set, the chart writes none, and every secret value here is ignored. MoreKeys: | |
| — | 64 hex characters ( Warning Keep it apart from the database’s backups, and never change it once there is data. | |
| — | The license. Optional: the first admin is asked for one after signing in. One loaded in the dashboard comes first while in force. | |
| — | The key to the operator console at | |
{} | Any other secret setting by its name, such as | |
| Mail7 | ||
none |
| |
| — | The sender, on a domain your mail service may send for. | |
| — | With | |
| — | With | |
587 |
| |
| — |
| |
| — | With | |
| PostgreSQL7 | ||
| — | Your database, PostgreSQL 15 or newer, as one address. It wins over the fields below. | |
| — | The host alone, without its port. With | |
require |
| |
| — | The CA for | |
| empty: 50 | The most connections each pod keeps ( | |
| empty: 5 | Connections the check keeps free for backups and an admin, at least 5. | |
false | Run the chart’s own PostgreSQL 15.6: one pod, an 8Gi volume, no backups. Evaluation only. | |
| Redis4 | ||
| — | Your Redis 6.2 or newer as one address, | |
| — | Separate fields: | |
false |
| |
false | Run the chart’s own Redis: one pod, a 2Gi volume, no replica. Evaluation only. | |
| Object storage7 | ||
none |
| |
gorunner | With | |
0 | Step data larger than this goes to the bucket. | |
| empty: 15 | How long one storage call may take. | |
| — | Your store’s address. | |
false |
| |
| — | With | |
| Bundled stores (evaluation)5 | ||
15. |
| |
7-alpine |
| |
4. |
| |
8Gi | Redis | |
| made once | Also MoreA first install derives them from | |
| The app15 | ||
2 | Keep at least 2, so a drain or a crash never leaves nobody to answer. | |
| 100m CPU, 256Mi–1Gi | CPU and memory for each. | |
90 | Runs that finished longer ago than this are deleted hourly, with their data. Each workflow keeps its newest finished run in each environment. | |
| empty: 1200 | Requests a minute per credential. Also | |
| empty: 12 | How long the embed renews its own session, 1 to 24 hours. | |
| — | Other websites that may call the API from a browser, separated by commas. | |
| empty: on |
| |
| — | More app callbacks AI apps may register: whole addresses, separated by commas, no query ( | |
false | Adds the caller’s address and browser to each request’s line ( | |
| — |
| |
60 | When a pod stops, how long it has to finish requests, after | |
true | Keep at least | |
ClusterIP | The Service in front of the app, on | |
[] | More environment variables for the app pods, as a Kubernetes | |
{} | Also | |
| The workers9 | ||
1 | More workers is the safer way to grow than larger ones. | |
4 | Runs one worker runs at once. Raise its memory limit with it. | |
| 250m CPU, 512Mi–2Gi | CPU and memory for each. | |
2 | Keel conversations one worker serves at once. | |
| — |
| |
| empty: 4 | Notifications to your server one worker sends at once. | |
| empty: 2 | Test step and connection tests one worker serves at once. | |
330 | How long a stopping worker may finish its runs. After that, another worker picks them up. | |
[] | And the same placement values as the app. | |
| Workflows3 | ||
| — | Private addresses steps may reach: empty for none, | |
| empty: 10000 | Runs of one organization that may wait before new ones are refused. | |
| empty: 1000 | The same for one workflow, editor test runs included. | |
| Migrations and the check6 | ||
true | Run the migrations Job at every install and upgrade. Leave it on. | |
[] | Extra flags, only when GoRunner asks. | |
6 | Retries. | |
86400 | The finished Job and its log go after a day. MoreThe Job is named after the Helm revision and the image ( | |
| 50m CPU, 64Mi–256Mi | CPU and memory for the Job. | |
true | A problem the check finds fails the Job. | |
| A company proxy3 | ||
| — | With | |
| — | Names reached directly. GoRunner adds its own, the cluster’s | |
| — |
| |
| Certificates and extra volumes1 | ||
[] | More volumes on every pod, with | |
| Monitoring5 | ||
| — |
| |
| — |
| |
false |
| |
| — |
| |
| — |
| |
| Any other setting1 | ||
{} | Any setting the values above don’t cover, by its name, such as | |
| Kubernetes8 | ||
true | GoRunner never calls the Kubernetes API, so the account holds no token. Also | |
| user 10001, non-root | With the default seccomp profile. | |
| read-only root | No privilege escalation, every capability dropped. | |
true | Only your controller and | |
| the ingress-nginx namespace | Who may reach the app. Change it for any other controller, or the app answers nobody. | |
[] | Who may read | |
true | The checks | |
| — | With | |