Kristoffer Dalby
7e0e423fbf
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 12:19:29 +01:00
Kristoffer Dalby
bff13ee823
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 12:19:29 +01:00
Kristoffer Dalby
cdd13b4e59
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 12:19:29 +01:00
Kristoffer Dalby
6db6129b62
config: let NixOS DNS records pass unknown fields to headscale
...
Updates #1926
2026-11-11 12:19:29 +01:00
Kristoffer Dalby
a6c914efb8
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 12:19:29 +01:00
Kristoffer Dalby
8c89030d48
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 12:19:29 +01:00
Kristoffer Dalby
f43583cbc6
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 12:19:29 +01:00
Kristoffer Dalby
4185b2481c
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 12:19:29 +01:00
Kristoffer Dalby
3dcc107efa
goreleaser: generate shipped config files, remove config-example.yaml
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
4c8f74775f
docs: add generated configuration reference and example
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
b92d27b7db
config: generate the configuration reference
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
63fdd50505
nix: add generated NixOS options
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
cd77d50bf6
cli: generate NixOS options from the config schema
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
439ea1b676
cli: add generate config, replacing dumpConfig
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
d247395ad7
gen/client/v1: regenerate for the running configuration endpoint
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
408ab0e947
api: serve the running configuration
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
76a6c24777
config: render the example configuration
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
b9c839b761
config: describe every key for the generators
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
0578c2a571
types: generate a table of config field docs
...
Updates #1926
2026-11-11 12:19:28 +01:00
Kristoffer Dalby
caecddd249
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 12:19:28 +01:00
Kristoffer Dalby
7d2f2a1b37
types: document every config field
...
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
cca1221ec7
hscontrol: validate configuration in NewHeadscale
...
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
48b5cffc96
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 11:19:27 +00:00
Kristoffer Dalby
e8e82ffe71
config: load configuration outside types
...
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
c6d25d12e1
types: decode configuration strictly
...
Fixes #2899
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
3a3a10edf9
types: give config values their own types
...
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
565aaf7e49
types: compute derived config values where they are used
...
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
c27285f224
types: remove viper
...
Updates #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
960c9a3f1d
types: reject unknown and removed config keys
...
Fixes #1926
2026-11-11 11:19:27 +00:00
Kristoffer Dalby
65e9ccedf6
types: load configuration with koanf
...
Updates #1926
2026-11-11 11:19:27 +00: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
Kristoffer Dalby
dc9513f472
tools/capver: fail on fetch errors instead of dropping versions
...
Retry 5xx, 429 and network errors with backoff, then fail.
Only 404 skips a version.
2026-11-06 14:25:24 +01:00
Kristoffer Dalby
017ab6b219
derp: skip DERP map sources that fail to load
...
Warn and start on what loaded; abort only if the served map, policy
derpMap included, has no region. Refresh still keeps the old map.
Fixes #3142
2026-11-06 14:03:08 +01:00
Kristoffer Dalby
a25aff2ccc
derp: reject non-200 DERP map responses
...
A JSON error page decoded to an empty map; a refresh then dropped
that URL's regions. Errors now name the URL.
Updates #3142
2026-11-06 14:03:08 +01:00
Kristoffer Dalby
8bc7e793a8
hscontrol: keep ACME retries on tls.acme.url
...
certmagic retried Let's Encrypt failures against staging, registering an account there.
Fixes #3589
2026-11-06 13:15:24 +01:00
Kristoffer Dalby
aa8d73ea1e
db: test too-old SQLite dumps are rejected unmodified
...
Adds a 0.22.3 dump; every fixture must fail before any write.
Updates #3648
2026-11-06 10:04:31 +01:00