headscale Infrastructure
Headscale self-hosted Tailscale control server, from source.
Pull this image
docker pull ghcr.io/rtvkiz/minimal-headscale:latestdocker pull ghcr.io/rtvkiz/minimal-headscale:latest-devThe -dev variant adds a shell, package manager and build toolchain. For CI and debugging — not production.
Details
- Repository
- ghcr.io/rtvkiz/minimal-headscale
- Size (compressed)
- 49 MB
- Built
- 2026-09-29T00:24:10Z (today)
- Architectures
- x86_64, aarch64
- Primary package
- headscale
- Entrypoint
- /usr/bin/headscale
- Cmd
- serve
- User
- nonroot (65532)
- Working dir
- /
- Architectures
- x86_64, aarch64
- Environment
- Labels
-
org.opencontainers.image.title minimal-headscale org.opencontainers.image.description Headscale is a self-hosted open source implementation of the Tailscale control server. Built from source, signed with SLSA provenance, rebuilt every six hours. org.opencontainers.image.url https://github.com/rtvkiz/minimal org.opencontainers.image.source https://github.com/rtvkiz/minimal/tree/main/images/headscale org.opencontainers.image.licenses BSD-3-Clause
- Entrypoint
- /usr/bin/headscale
- Cmd
- serve
- User
- nonroot (65532)
- Working dir
- /
- Architectures
- x86_64, aarch64
- Environment
- Labels
-
org.opencontainers.image.title minimal-headscale-dev org.opencontainers.image.description Dev variant of minimal-headscale: same binary plus shell, curl, openssl, dig and jq. Not for production. org.opencontainers.image.url https://github.com/rtvkiz/minimal org.opencontainers.image.source https://github.com/rtvkiz/minimal/tree/main/images/headscale org.opencontainers.image.licenses BSD-3-Clause dev.minimal.variant dev
| Tag | Pull | Published |
|---|---|---|
| 0.29 | ghcr.io/rtvkiz/minimal-headscale:0.29 | 2026-09-29 |
| 0.29.4-r0 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0 | 2026-09-29 |
| 0.29.4-r0-20260929 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260929 | 2026-09-29 |
| latest | ghcr.io/rtvkiz/minimal-headscale:latest | 2026-09-29 |
| 0.29-dev | ghcr.io/rtvkiz/minimal-headscale:0.29-dev | 2026-09-29 |
| 0.29.4-r0-20260929-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260929-dev | 2026-09-29 |
| 0.29.4-r0-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-dev | 2026-09-29 |
| latest-dev | ghcr.io/rtvkiz/minimal-headscale:latest-dev | 2026-09-29 |
| 0.29.4-r0-20260928 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260928 | 2026-09-28 |
| 0.29.4-r0-20260928-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260928-dev | 2026-09-28 |
| 0.29.4-r0-20260927 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260927 | 2026-09-27 |
| 0.29.4-r0-20260927-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260927-dev | 2026-09-27 |
| 0.29.4-r0-20260926 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260926 | 2026-09-26 |
| 0.29.4-r0-20260926-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260926-dev | 2026-09-26 |
| 0.29.4-r0-20260925 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260925 | 2026-09-25 |
| 0.29.4-r0-20260925-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260925-dev | 2026-09-25 |
| 0.29.4-r0-20260924 | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260924 | 2026-09-24 |
| 0.29.4-r0-20260924-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.4-r0-20260924-dev | 2026-09-24 |
| 0.29.3-r0 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0 | 2026-09-24 |
| 0.29.3-r0-20260924 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260924 | 2026-09-24 |
| 0.29.3-r0-20260924-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260924-dev | 2026-09-24 |
| 0.29.3-r0-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-dev | 2026-09-24 |
| 0.29.3-r0-20260923 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260923 | 2026-09-23 |
| 0.29.3-r0-20260923-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260923-dev | 2026-09-23 |
| 0.29.3-r0-20260922 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260922 | 2026-09-22 |
| 0.29.3-r0-20260922-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260922-dev | 2026-09-22 |
| 0.29.3-r0-20260921 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260921 | 2026-09-21 |
| 0.29.3-r0-20260921-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260921-dev | 2026-09-21 |
| 0.29.3-r0-20260920 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260920 | 2026-09-20 |
| 0.29.3-r0-20260920-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260920-dev | 2026-09-20 |
| 0.29.3-r0-20260919 | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260919 | 2026-09-19 |
| 0.29.3-r0-20260919-dev | ghcr.io/rtvkiz/minimal-headscale:0.29.3-r0-20260919-dev | 2026-09-19 |
14 packages in the image, resolved from the SPDX SBOM.
| Package | Version | License |
|---|---|---|
| alpine/ca-certificates | 20260909 | MPL-2.0 AND MIT |
| ca-certificates-bundle | 20260909-r1 | MPL-2.0 AND MIT |
| ca-certificates-bundle | 20260909-r1 | (MPL-2.0 AND MIT) |
| ca-certificates-bundle | 20260909-r1 | — |
| ca-certificates.yaml | ee3eac73dda22e8dd32fa5fb3e3a1712a6e812d7 | Apache-2.0 |
| headscale | 0.29.4-r0 | BSD-3-Clause |
| images/headscale/melange.yaml | 1bce6e63ea891bcced1fda6bdc6813ced3474c4e | — |
| sha256:294a3e168c8889a9dc8cee0253f82183c83686983a6639fa15784536052276f2 | sha256:294a3e168c8889a9dc8cee0253f82183c83686983a6639fa15784536052276f2 | — |
| sha256:c00d800822c472900fcf678d63245b46b4be20028c59e217d64e1d59244e54a7 | 20230201 | — |
| wolfi | 20230201 | — |
| wolfi-baselayout | 20230201-r30 | MIT |
| wolfi-baselayout | 20230201-r30 | MIT |
| wolfi-baselayout | 20230201-r30 | — |
| wolfi-baselayout.yaml | a4472f6292a5e48d6d611bf24c6e119b1a483e66 | Apache-2.0 |
0 fixable
| CVE | Severity | Package | Installed | Fixed in |
|---|---|---|---|---|
| GO-2026-5932 | Unknown | golang.org/x/crypto | v0.57.0 | — |
Everything is verifiable without an account. Copy and run:
Build provenance (SLSA v1.0, Build L2)
gh attestation verify oci://ghcr.io/rtvkiz/minimal-headscale:latest --owner rtvkizCosign signature
cosign verify \
--certificate-identity-regexp='https://github.com/rtvkiz/minimal/' \
--certificate-oidc-issuer='https://token.actions.githubusercontent.com' \
ghcr.io/rtvkiz/minimal-headscale:latestSBOM attestation (SPDX)
cosign verify-attestation --type spdxjson \
--certificate-identity-regexp='https://github.com/rtvkiz/minimal/' \
--certificate-oidc-issuer='https://token.actions.githubusercontent.com' \
ghcr.io/rtvkiz/minimal-headscale:latest \
| jq -r '.payload | @base64d | fromjson | .predicate'Signatures are logged in the public Rekor transparency log.
More Infrastructure images
Weighing this against another provider? The comparison pages publish head-to-head scan data with the raw dataset, including the images where Minimal comes off worse — or read the migration guide for what actually breaks when you switch.