Another headscale chart that support OIDC (and other secrets from existingSecrets)

headscale helm

Find a file

jessebot bcb97c04eb note local instructions distinction		2026-02-05 22:32:58 +00:00
.forgejo/workflows	run on push and only for charts dir and remove setup step	2026-02-05 20:58:59 +00:00
charts/headscale	clean up docs	2026-02-04 11:48:42 +01:00
LICENSE	move license to root directory so readme is included 😅	2026-02-04 10:23:38 +01:00
README.md	note local instructions distinction	2026-02-05 22:32:58 +00:00

Headscale helm chart

This is another helm chart for headscale. (This is not officially affiliated with headscale. We're just huge fans)

Features:

documented values.yaml file with accompanying README for ease of use
optionally use existing Kubernetes Secrets for sensitive init data (private keys, OIDC credentials)
optionally use existing Persistent Volume Claims
the entire headscale config file is able to be templated
no self referencing helm values in the values.yaml
hosted on the git.smallhack.org Forgejo and mirrored to Codeberg for backup

Uses the official upstream docker image: headscale/headscale

Getting Started

We have this pushed to our harbor instance as an OCI, so you can pull it like this:

helm pull oci://harbor.smallhack.org/smallhack/headscale --version 0.1.0

If you're testing locally, you can clone the repo:

git clone https://git.smallhack.org/small-hack/headscale-chart

Then go over to the charts/headscale directory:

cd headscale-chart/charts/headscale

And run:

helm install .