Kristoffer Dalby
c18f4f27a9
cli: check config without opening the database
...
Fixes #3443
2026-11-06 15:54:20 +00:00
Kristoffer Dalby
4b2eaba1ed
cli: check policies offline by default
...
Fixes #3355
2026-11-06 15:38:33 +00: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
Florian Preinstorfer
7af39a6798
Add headscale-panel to webui docs
2026-06-20 10:41:57 +02:00
Florian Preinstorfer
d7150755d4
TLS is not strictly required
2026-06-19 18:52:30 +02:00
Florian Preinstorfer
88234d4046
Replace /swagger with /api/v1/docs
2026-06-19 18:52:30 +02:00
Kristoffer Dalby
72adc5ff2a
docs: add changelog and refresh the API reference for the v1 API
2026-06-19 15:21:00 +02:00
Florian Preinstorfer
6777a82ee6
Rewrite reverse proxy documentation
...
- Restructure and cleanup reverse proxy docs
- Update examples for Apache, Caddy, Nginx
- Provide some basic usage examples
2026-06-04 09:59:19 +02:00
Florian Preinstorfer
e285f3c932
The headscale service is enabled by default
2026-05-18 17:21:58 +02:00