headscale/docs/ref
Kristoffer Dalby 4d0b273b90 types: add node.expiry config, deprecate oidc.expiry
Introduce a structured NodeConfig that replaces the flat
EphemeralNodeInactivityTimeout field with a nested Node section.

Add node.expiry config (default: no expiry) as the unified default key
expiry for all non-tagged nodes regardless of registration method.

Remove oidc.expiry entirely — node.expiry now applies to OIDC nodes
the same as all other registration methods. Using oidc.expiry in the
config is a hard error. determineNodeExpiry() returns nil (no expiry)
unless use_expiry_from_token is enabled, letting state.go apply the
node.expiry default uniformly.

The old ephemeral_node_inactivity_timeout key is preserved for
backwards compatibility.

Updates #1711
2026-04-08 13:00:22 +01:00
..
integration Add more UIs 2026-02-16 15:22:46 +01:00
acls.md Reformat docs with mdformat 2026-03-01 09:24:52 +01:00
api.md Update docs for auth-id changes 2026-03-01 13:38:22 +01:00
configuration.md Reformat docs with mdformat 2026-03-01 09:24:52 +01:00
debug.md Document how to disable the metrics interfaces 2026-01-16 14:54:04 +01:00
derp.md Reformat docs with mdformat 2026-03-01 09:24:52 +01:00
dns.md Reformat docs with mdformat 2026-03-01 09:24:52 +01:00
oidc.md types: add node.expiry config, deprecate oidc.expiry 2026-04-08 13:00:22 +01:00
registration.md Explicitly mention that a headscale username should *not* end with @ 2026-03-20 19:44:33 +01:00
routes.md Fix ownership description for auto approved routers/exits 2026-01-16 14:54:04 +01:00
tags.md Update docs for auth-id changes 2026-03-01 13:38:22 +01:00
tls.md Reformat docs with mdformat 2026-03-01 09:24:52 +01:00