Kristoffer Dalby
f5f86e69d0
config: require listen_addr and the sqlite path
...
Empty values serve cannot use; empty server_url reads "is required".
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
2db863d5e6
config: clear a key from the environment with ""
...
A HEADSCALE_* value of "" means what key: "" means in a file, errors
included, so an env-only setup can clear a defaulted key. An empty
variable still counts as unset.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
542fe8dd55
config: give every key but server_url a working default
...
server_url alone, in a file or HEADSCALE_SERVER_URL, now passes check config.
Fixes #3567
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
57a18b8c41
hscontrol: refresh the DERP map without blocking other scheduled tasks
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
fcb1d42b86
nix: check the configuration while building the system
...
check.config also runs `check config -f` on the generated file at build
time, native only, under the unit's environment.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
3a35f74873
nix: build the module on the generated options
...
settings mirrors headscale's keys one to one, headscale's checks judge the
rest, and the local CLI gets the socket from a variable instead of a file.
headscale always runs as headscale:headscale, which the module creates;
user and group are read-only, so setting either fails evaluation, and stay
only because nixpkgs' headplane module reads them. A settings.cli key
fails evaluation instead of being dropped with a warning, and the unit no
longer gets CAP_CHOWN.
nix/example-configuration.nix goes: the options carry its examples and
defaults.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
cf8362e1a9
config: pin what the NixOS module writes for a minimal configuration
...
The module is about to move to the generated options; this frozen output
is what its effective configuration must still load to.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
afa16d056e
nix, docs: regenerate NixOS options and the configuration reference
...
Read-only file options take Nix paths; key and state file options take
only absolute paths outside the Nix store; DNS records pass unknown
fields; db_password_file and dns.split appear as removed keys.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
f0a4f6ca67
config: let NixOS DNS records pass unknown fields to headscale
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
c7d097d65e
config: log a missing config file only for serve
...
The environment alone is a complete configuration and client commands
need a file only for an API key, so the loader stops warning; serve logs
at info level that it runs on defaults and the environment.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
69a9bb3e88
config: name the NixOS module's old settings keys as removed
...
db_password_file and dns.split were rejected only by the NixOS module;
Go now names their replacements, so the module can drop its list.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
98e9559a57
config: let NixOS options for read-only files take Nix paths
...
A nix:"path" tag types policy.path, dns.extra_records_path and
tls.cert_path as an absolute path or "", and derp.paths as a list of
paths, so pkgs.writeText and ./policy.hujson work. A nix:"external" tag
types key and state files as an absolute path outside the Nix store, so
no private key is copied into the world-readable store.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
0844b7649d
nix: check the policy at build time and the config before a switch
...
Store-path policy: check policy -f in system.checks.
Pre-switch: check all as the headscale user.
Adapted: no file: secret warning; groups as after activation; a new primary
group skips; the policy the unit's env selects; docs say which check covers
the policy; VM case for the unit's env.
(cherry picked from commit b6ba6e42ee )
Fixes #2898
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
fe908c2d5a
goreleaser: generate shipped config files, remove config-example.yaml
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
42a74821bc
docs: add generated configuration reference and example
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
ea5e6893a3
config: generate the configuration reference
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
8405c248e1
nix: add generated NixOS options
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
d437b271ce
cli: generate NixOS options from the config schema
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
6602227d3e
cli: add generate config, replacing dumpConfig
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
f7f1d91d0f
gen/client/v1: regenerate for the running configuration endpoint
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
59ebffd64a
api: serve the running configuration
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
92ccd62eb1
config: render the example configuration
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
a2e5e36ab2
config: describe every key for the generators
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
2aab876be8
types: generate a table of config field docs
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
90de2ed00d
config: keep every default in Default
...
The DNS-01 challenge resolvers, dns.challenge.resolvers, now default to
Quad9 (9.9.9.9:53, 149.112.112.112:53) instead of Cloudflare and
Google.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
d835c9c6bf
types: document every config field
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
e9abc6ae35
hscontrol: validate configuration in NewHeadscale
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
4dbf981679
config: make the loaded configuration round-trip
...
Configuration keys now match only as written, in lower case. BREAKING:
Server_URL is an unknown key, where 0.29 and the previous commits
ignored case. Each key has one spelling, the one the dump prints.
Open-map entry names keep their own rule: split DNS domains and
provider settings are lowercased, oidc.extra_params keeps case.
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
f1cbdcfacb
config: load configuration outside types
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
890adee7fa
types: decode configuration strictly
...
Fixes #2899
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
865c001068
types: give config values their own types
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
77491a5bd8
types: compute derived config values where they are used
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
3e12fa9d39
types: remove viper
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
cb4ccd97c2
types: reject unknown and removed config keys
...
Fixes #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
7328157817
types: load configuration with koanf
...
Updates #1926
2026-11-11 15:02:16 +01:00
Kristoffer Dalby
443f3a0ecd
types: pin effective config of shipped examples
...
Updates #1926
2026-11-11 12:19:23 +01:00
Kristoffer Dalby
167f4f646f
prek: run treefmt hook serially
...
Parallel nix fmt batches time out on treefmt's cache lock.
Updates #1926
2026-11-11 12:19:23 +01:00
Kristoffer Dalby
8a291dfc9d
types: add config compatibility fixtures
...
Frozen real-world config inputs for the compat goldens; formatter skips them.
Updates #1926
2026-11-11 12:19:23 +01:00
Kristoffer Dalby
bd3495d8d2
types: reject unknown policy.mode
...
A typo booted with no policy, allowing all traffic.
Updates #1926
2026-11-11 12:19:22 +01:00
Kristoffer Dalby
ae6ea2cce4
cli: add check config and check all
...
check config validates only the config; check all adds one
ok/FAIL/skip line per named file.
Fixes #3443
2026-11-11 12:19:22 +01:00
Kristoffer Dalby
0208434691
config: validate the files a config names
...
New package hscontrol/config: Files lists each file a config
names with its validator; ReadPrivateKey moves here.
Updates #3443
2026-11-11 12:19:22 +01:00
Kristoffer Dalby
5de40d9528
github: regenerate integration test list
...
Updates #3355
2026-11-11 12:06:27 +01:00
Kristoffer Dalby
f5fd1d16cf
cli: add check policy
...
check policy and policy set share ValidatePolicy; tests and sshTests
run against stand-ins built from the policy. Replaces policy check.
Fixes #3355
2026-11-11 12:06:27 +01:00
Kristoffer Dalby
0fe0545b3d
cli: add check command group that loads config on demand
...
Updates #3355
2026-11-11 12:06:27 +01:00
Kristoffer Dalby
626f400d54
policy/v2: name the tester compat skip lists like the others
...
Updates #3355
2026-11-11 12:06:27 +01:00
Kristoffer Dalby
7989fed78e
servertest: return from NewClient after the first map
...
HA tests expect the first router created to hold the older control
session; under load its stream connected later and the standby won.
2026-11-10 15:55:42 +01:00
Kristoffer Dalby
e49629ebf3
goreleaser: build with -trimpath
...
Release logs showed the CI runner's checkout path on every Caller() line; nix builds already trim.
2026-11-10 15:55:25 +01:00
Kristoffer Dalby
48416ce089
tools/capver: test 429 and dropped-connection retries
2026-11-06 14:25:24 +01:00
Kristoffer Dalby
9a199a7e7e
tools/capver: add blank line before range for wsl
2026-11-06 14:25:24 +01:00
Kristoffer Dalby
4a531ec7a2
tools/capver: fetch tailcfg.go from raw.githubusercontent.com
...
github.com/raw only redirects there, and its edge serves stale 504s.
2026-11-06 14:25:24 +01:00