headscale/nix
Kristoffer Dalby a5152db397 nix: build the headscale and tailscale-HEAD test images
Replaces the Dockerfile builds for the flake-check path. headscale is built
from the Go-filtered source; one tailscale-HEAD image serves client, daemon,
derper and the websocket-DERP test. Released tailscale versions and postgres
are pinned registry pulls, arch following the build system. Tools the suite
used to apk-add (curl/ssh/dig/python3) and the SSH login users are baked in at
build time so no container is mutated at startup, and busybox su is included so
taildrive can fork its per-user fileserver.
2026-07-01 12:11:51 +00:00
..
tests nix: disable external DERP URL fetch in VM test 2026-03-06 05:18:44 -08:00
example-configuration.nix nix: add NixOS module and tests (#2857) 2025-11-12 13:11:38 +00:00
images.nix nix: build the headscale and tailscale-HEAD test images 2026-07-01 12:11:51 +00:00
module.nix Update links to Tailscale documentation 2026-04-18 09:33:41 +02:00
README.md nix: add NixOS module and tests (#2857) 2025-11-12 13:11:38 +00:00

Headscale NixOS Module

This directory contains the NixOS module for Headscale.

Rationale

The module is maintained in this repository to keep the code and module synchronized at the same commit. This allows faster iteration and ensures the module stays compatible with the latest Headscale changes. All changes should aim to be upstreamed to nixpkgs.

Files

Usage

Add to your flake inputs:

inputs.headscale.url = "github:juanfont/headscale";

Then import the module:

imports = [ inputs.headscale.nixosModules.default ];

See example-configuration.nix for configuration options.

Upstream

The module in this repository may be newer than the nixpkgs version.