headscale v0.29.2 released on 01-07-2026
headscale v0.29.2 is out now. Operators and clients benefit from a fix for map-generation lock contention that caused reconnect storms, restored WebSocket GET upgrades on /ts2021 for Tailscale JS/WASM control clients, and safer handling of invalid FQDNs that previously broke map delivery.
Read the full notes on the project’s GitHub and follow the official upgrade guide before updating: github.com/juanfont/headscale · headscale.net/stable/setup/upgrade/
What’s in this release
- Map generation now takes read locks where appropriate so serialization no longer stalls clients during mass reconnects (fixes reconnect-storm and lock-concurrency issues).
- /ts2021 now accepts WebSocket GET upgrades (previously returned 405), restoring connectivity for Tailscale JS/WASM control clients and adding integration tests including a real WASM client.
- Nodes with invalid FQDNs (empty or exceeding hostname limits) are skipped during map delivery, logged at startup with guidance, and renames that would exceed hostname limits are rejected.
Upgrade notes
- Follow the official upgrade guide before updating: https://headscale.net/stable/setup/upgrade/
- No specific rollback instructions are included in the release notes; revert using your existing rollback procedures if required.
Let others know how the upgrade went — share comments or report any regressions on the project’s GitHub repository.
