Kristoffer Dalby
36917c0787
docs: describe the strict configuration and its generated reference
...
Updates #3567
Updates #1926
2026-11-17 11:20:18 +00:00
Kristoffer Dalby
f5f05440b3
types, docs, nix: regenerate the configuration docs
...
Updates #1926
2026-11-17 11:20:09 +00:00
Kristoffer Dalby
ce295d6782
nix, docs: regenerate config reference
...
Updates #3588
2026-11-11 17:54:31 +01:00
Kristoffer Dalby
07859e5ff6
types, docs, nix: regenerate config docs for write_ahead_log
...
Updates #1926
2026-11-11 17:32:36 +01:00
Kristoffer Dalby
934a1f12b8
docs: regenerate configuration reference
...
Updates #1926
2026-11-11 16:42:44 +01:00
Kristoffer Dalby
6247fc59e5
nix, docs: regenerate NixOS options and the configuration reference
...
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
42a74821bc
docs: add generated configuration reference and example
...
Updates #1926
2026-11-11 15:02:16 +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
49ddd3d412
docs: describe update-client as Tailscale answers it
...
auto_update.enabled reaches only nodes with no stored setting.
Updates #3629
2026-11-05 15:51:04 +01:00
Martín Gómez
f203c003eb
docs: document updating clients remotely
2026-11-05 15:51:04 +01:00
Kristoffer Dalby
9332d2d022
docs: describe which rules offer exit nodes
...
Exit routes need a rule to the internet. via grants add up; plain internet rules bypass via.
2026-11-05 15:34:46 +01:00
Kristoffer Dalby
6f2c7fbe7d
derp: check derp.paths and derp.urls regions like a policy derpMap
...
Clients count latency by RegionID, so a key mismatch picks a missing home.
Updates #2918
2026-11-05 14:11:33 +01:00
Kristoffer Dalby
1a635e7d08
docs: document the policy derpMap
...
Updates #2918
2026-11-05 14:11:33 +01:00
Kristoffer Dalby
e358a539af
derp: reject unknown keys in derp.paths files
...
SaaS rejects them in a policy derpMap; a misspelt key silently did nothing.
Updates #2918
2026-11-05 14:11:33 +01:00
Kristoffer Dalby
00f9373246
docs: document DERP region scores
...
Updates #2918
2026-11-05 14:11:33 +01:00
Kristoffer Dalby
459b157c3b
docs: note the posture attributes endpoint and its proxy setting
...
trusted_proxies now feeds a stored, API-visible address, not only logs.
Updates #2272
2026-11-05 12:38:53 +01:00
Kristoffer Dalby
1bce65a236
policy/v2: name ssh-behavior-v1 a deliberate difference
...
SaaS stamps it on every node. Sending it would change existing users' login
environment, so it stays a nodeAttr. Document that and pin it.
2026-11-03 17:05:00 +01:00
Kristoffer Dalby
b3ffec4269
hscontrol: reload manual TLS certificate on SIGHUP
...
Files that fail to load or are not valid now keep the previous certificate.
Fixes #3027
Claude-Session: https://claude.ai/code/session_01RHEZM1qJ2hgndiXio7P56h
2026-11-03 15:52:52 +01:00
Igor Serganov
d0e10f2d46
util: read .json files as HuJSON in UnmarshalByExt ( #3634 )
...
dns.extra_records_path and derp.paths files ending in .json were decoded
with encoding/json, so a comment or trailing comma in otherwise valid
JSON made headscale refuse to load the file. Policy files already accept
HuJSON regardless of extension. HuJSON is a superset of JSON, so
standardizing .json input the same way as .hujson keeps every valid JSON
file decoding exactly as before.
Add tests for comments and trailing commas in extra records, in generic
.json decoding and in ACL policies, and for comment markers inside
string values.
Fixes #3627
2026-11-02 20:35:24 +01:00
Kristoffer Dalby
4e946edb08
api/v2: enforce and document OAuth tag permissions
...
Retagging requires all current and requested tags; disallowed tags return
400. Token responses list tags only when the token may assign them.
2026-11-02 19:15:40 +01:00
Kristoffer Dalby
9979be140e
db: keep at most 1000 access tokens per OAuth client
...
Minting needs only the client secret, whatever its scopes, and
added one row per mint. Each mint now ends tokens past the newest 1000.
2026-11-02 19:15:40 +01:00
Kristoffer Dalby
75e2377f25
debug: refuse requests addressed to unknown host names
2026-11-02 19:15:40 +01:00
Kristoffer Dalby
5dff6ca432
policy/v2: resolve user references consistently across updates
...
Prefer email owners over usernames and validate grants and nodeAttrs on
write. Reject ambiguous writes; log and match nobody on reload. Bare @
matches nobody.
2026-11-02 19:15:40 +01:00
Kristoffer Dalby
14baf55421
state, oidc: persist user changes and refresh nodes and clients
...
Write cleared user columns, discard OIDC email the provider no longer
vouches for, refresh NodeStore users, and notify clients from the callback.
Fixes #3471
2026-11-02 19:15:40 +01:00
Kristoffer Dalby
4342883bd4
policy/v2, state: elect primaries by oldest control session
...
A router that reconnects joins as a standby; one that kept its session
takes its routes back once available again, as on Tailscale. Both the
global and the via election use it, in place of anti-flap stickiness.
2026-11-02 19:15:40 +01:00
Kristoffer Dalby
c0925962c2
hscontrol: bound pending authentication without evicting sessions
2026-10-29 20:51:50 +01:00
Kristoffer Dalby
2e8611c159
docs: use tls block keys and describe CertMagic
...
Updates #2527
2026-10-18 20:53:18 +02:00
Kristoffer Dalby
694587bfa0
docs: mark Serve as supported
...
HTTPS serve needs dns.certificates; Funnel and Services stay unsupported.
Updates #1921
2026-10-18 20:53:18 +02:00
Kristoffer Dalby
29e18d80b4
docs: note the audit-log shutdown lasts until tailscale up
...
Clients that opt out of logging themselves hit it whatever logtail.enabled says.
2026-10-07 18:11:07 +02:00
Kristoffer Dalby
52a7f8c89c
mapper: send the logtail instruction on every full map
...
Full maps moved to buildFromChange and lost WithDebugConfig, so no
frame told clients to disable log upload. Enabled logtail sends nil.
2026-10-07 18:11:07 +02:00
Sandro
5f03627408
Update link to node attributes
2026-10-06 05:30:26 +02:00
yuwk
3486ab2fc2
docs: fix "is may be" grammar in policy reference
...
Signed-off-by: yuwk <1729065730@qq.com >
2026-09-29 18:30:38 +02:00
yuwk
32939914d3
docs: fix "specfic" typo in policy reference
...
Signed-off-by: yuwk <1729065730@qq.com >
2026-09-29 18:30:38 +02:00
Kristoffer Dalby
62f89ca25d
cli: accept a user name in preauthkeys create --user
...
Resolved through lookupUser like the users commands, so scripts skip the
users list round trip. Digit-only values stay IDs.
2026-09-28 21:42:19 +02:00
Kristoffer Dalby
906016beb4
dns: pick the extra_records_path format by file extension
...
HuJSON and YAML records work too; an unknown extension fails instead of being
parsed as JSON.
2026-09-28 21:42:19 +02:00
Kristoffer Dalby
dd8ce695cf
derp: pick the derp.paths format by file extension
...
Adds JSON and HuJSON maps. JSON read as YAML decoded to an empty map; unknown
extensions and empty maps now fail at startup.
2026-09-28 21:42:19 +02:00
github-actions[bot]
8548583f0e
docs: raise 3 docs requirement floors
2026-09-28 07:28:19 +02:00
Kristoffer Dalby
eebeab3c1e
docs: document joining nodes with an OAuth client
...
Prefix swap, baseURL, every attribute; examples for tailscale up,
container, tsnet, GitHub Action.
2026-09-25 17:09:19 +02:00
Kristoffer Dalby
616c9b6495
docs: warn about listen_addr / ACME port collision
...
Add a callout under the HTTP-01 docs so operators see the
constraint before they hit the validation error at startup.
Updates #3227
2026-09-23 15:18:34 +02:00
Florian Preinstorfer
4087d1fee9
Use tmpfs for /tmp
...
This is relevant when docker is used as container runtime as it does not
set /tmp as tmpfs. With podman /tmp is mounted as tmpfs due to
`--read-only-tmpfs` (enabled by default).
Fixes : #3463
2026-09-10 14:12:53 +02:00
Florian Preinstorfer
38722e5eeb
Document automatic exit node selection and related node attributes
...
- Add "Automatic exit node selection" to route docs
- Add suggest-exit-node and suggest-exit-node-ui as supported nodeAttrs
Fixes : #3444
2026-09-08 10:32:27 +02:00
Florian Preinstorfer
febe3ee341
Document how to disable remote client logging on mobile
2026-09-08 10:32:27 +02:00
Lukas Wolfsteiner
89fa72e08f
docs: add repository star count and activity badges to web UI list
2026-09-02 13:33:22 +02:00
Igor Bernstein
cbe30304dc
docs: reword the tvOS warning to match the new step order
...
The steps now open the Tailscale app first to install the VPN
configuration, which contradicted the warning against opening the app
after installation. The actual constraint is not signing in before the
headscale URL is set.
2026-08-29 18:18:35 +02:00
igorbernstein
fad937c062
Update AppleTV configuration steps
...
The instructions didn't work for tvOS 26.6 / Tailscale 1.102.2. When the `ALTERNATE COORDINATION SERVER URL` is set, the `Install VPN Configuration` breaks.
Clicking does nothing and the tvOS app logs showed `addUser: backendManager does not exist`.
Instead I first started tailscale and installed the vpn profile and then add the headscale url and then signed. Which seemed to have worked
2026-08-29 18:18:35 +02:00
Kristoffer Dalby
f06ff1cf81
all: build with Go 1.27
...
Bump every remaining toolchain reference: images, goreleaser, the hi
runner fallback and docs.
2026-08-25 21:59:00 +02:00
Baptiste Fontaine
ec0cb6f63a
docs: fix typos
2026-06-24 11:23:20 +02:00
Florian Preinstorfer
a066a06bef
Fix invalid ip syntax
...
The "ip" field needs to be a list.
2026-06-24 08:27:33 +02:00
Florian Preinstorfer
3c504af2be
Fix placeholder in curl example
2026-06-20 10:41:57 +02:00