> For the complete documentation index, see [llms.txt](https://docs.pipekit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pipekit.io/reference/helm-values/self-hosted.md).

# Self-Hosted Chart

The Self-Hosted Pipekit Helm chart (`pipekit/pipekit`) installs the entire stack (UI, API, ID service, Postgres, Pipekit Agent) into a single Kubernetes namespace.

This page links to the canonical values reference and covers the most commonly tuned values. For the install procedure, see [Self-Hosting > Deploy > Helm Install](/self-hosting-pipekit/dependencies/helm-install.md). For a 30-minute trial install on a local cluster, see [Self-Hosting > Evaluate Self-Hosted](/self-hosting-pipekit/evaluate.md).

## Discovering values

The Pipekit values file is commented in-place. Every value's purpose is documented next to it. To dump the values for the version you have installed:

```bash
helm show values pipekit/pipekit --version <version>
```

For your current install's values:

```bash
helm get values pipekit -n pipekit
```

## Required values

| Value                     | Type      | Purpose                                                                                       |
| ------------------------- | --------- | --------------------------------------------------------------------------------------------- |
| `license.key`             | string    | Your Pipekit license key. Required for any non-`dev` install.                                 |
| `global.deployType`       | enum      | `dev` for local evaluation; `ci` for CI; `prod` for production. Controls resource defaults.   |
| `imagePullSecrets[].name` | string\[] | Name of the `regcred` Secret with credentials for the `pipekitprivate` Docker Hub repository. |

## Common production tunings

| Value                                                        | Purpose                                                                                                                |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `<service>.replicas`                                         | Replica count per service. Defaults are sized for `dev`; bump for `prod`.                                              |
| `<service>.resources.requests`                               | CPU and memory requests per service. The `dev` defaults are small; production deployments typically scale these 4-10x. |
| `<service>.hpa.enabled`                                      | Enable the Horizontal Pod Autoscaler for a service.                                                                    |
| `<service>.hpa.{min,max}Replicas`                            | HPA replica bounds.                                                                                                    |
| `<service>.pdb.enabled`                                      | Enable a Pod Disruption Budget. Strongly recommended for `prod`.                                                       |
| `gitProviders.{github,gitlab,bitbucket,azureDevOps}.enabled` | Enable a Git provider. See [Configure > Git Provider](/self-hosting-pipekit/initial-login/git-provider.md).            |
| `gatewayAPI.enabled`                                         | Use Gateway API resources instead of Ingress. Pair with `gatewayAPI.httpRoute`.                                        |
| `postgres.external.enabled`                                  | Point Pipekit at a managed Postgres instead of the in-cluster bundled instance. Required for production HA.            |

## Where each service's values live

Each Pipekit service has its own block in the chart's `values.yaml`. The blocks all follow the same shape: image, resources, replicas, hpa, pdb, livenessProbe, readinessProbe.

| Service          | Block prefix        | Notes                                                                                                 |
| ---------------- | ------------------- | ----------------------------------------------------------------------------------------------------- |
| UI               | `ui.*`              | Web app; usually behind an ingress or Gateway HTTPRoute.                                              |
| Users API        | `users.*`           | Main API for Pipes/Runs/Workflows.                                                                    |
| ID               | `id.*`              | Authn (SSO, MFA, user creation).                                                                      |
| Events Handler   | `eventsHandler.*`   | Webhook receiver for Git providers; only enabled if you wire up GitHub/GitLab/Bitbucket/Azure DevOps. |
| Messenger        | `messenger.*`       | Redis-backed queue + log broker between Users and Pipekit Agent.                                      |
| Notifications    | `notifications.*`   | Email / Slack / Teams alert dispatch.                                                                 |
| Pipekit Agent    | `pipekitAgent.*`    | In-cluster component. Often configured separately via the agent's own Helm chart.                     |
| Metrics Operator | `metricsOperator.*` | OTel-based workflow metrics. Optional.                                                                |
| Postgres         | `postgres.*`        | Embedded for dev; external for prod.                                                                  |

For the full annotated reference, see [Self-Hosting > Deploy > Helm Install](/self-hosting-pipekit/dependencies/helm-install.md#changes-to-the-default-valuesyaml), which embeds the chart's `values.yaml` with every parameter documented inline.

## Related

* [Agent Chart Values](/reference/helm-values/agent.md): values reference for the `pipekit-agent` chart used in BYOC / Pipekit Cloud deployments.
* [Self-Hosting > Configure](/self-hosting-pipekit/initial-login.md): post-install configuration (initial login, SSO, Git providers, agent options).