mirror of https://github.com/juanfont/headscale.git synced 2026-03-12 05:21:50 +01:00

Files

Kristoffer Dalby 65880ecb58 nix: disable external DERP URL fetch in VM test

Explicitly set derp.urls to an empty list in the NixOS VM test,
matching the upstream nixpkgs test. The VMs have no internet
access, so fetching the default Tailscale DERP map would silently
fail and add unnecessary timeout delay to the test run.

2026-03-06 05:18:44 -08: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

module.nix

nix: sync module options and descriptions with upstream nixpkgs

2026-03-06 05:18:44 -08:00

README.md

nix: add NixOS module and tests (#2857 )

2025-11-12 13:11:38 +00:00

README.md

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

module.nix - The NixOS module implementation
example-configuration.nix - Example configuration demonstrating all major features
tests/ - NixOS integration tests

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.