Download Latest Version
v0.29.3 source code.zip (44.3 MB)
Get an email when there's a new version of Headscale
| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| checksums.txt | 2026-07-01 | 767 Bytes | |
| headscale_0.29.2.tar.gz | 2026-07-01 | 99.1 MB | |
| headscale_0.29.2_linux_amd64.deb | 2026-07-01 | 20.0 MB | |
| headscale_0.29.2_linux_arm64.deb | 2026-07-01 | 18.4 MB | |
| headscale_0.29.2_freebsd_amd64 | 2026-07-01 | 51.2 MB | |
| headscale_0.29.2_darwin_amd64 | 2026-07-01 | 52.8 MB | |
| headscale_0.29.2_darwin_arm64 | 2026-07-01 | 50.0 MB | |
| headscale_0.29.2_linux_amd64 | 2026-07-01 | 52.4 MB | |
| headscale_0.29.2_linux_arm64 | 2026-07-01 | 49.2 MB | |
| README.md | 2026-07-01 | 1.7 kB | |
| v0.29.2 source code.tar.gz | 2026-07-01 | 43.3 MB | |
| v0.29.2 source code.zip | 2026-07-01 | 44.3 MB | |
| Totals: 12 Items | 480.8 MB | 2 | |
Changes
- Fix map generation serializing on the policy lock, so a mass reconnect on
autogroup:self, via or relay policies no longer stalls clients intounexpected EOFretry loops #3358 - Fix
/ts2021rejecting the WebSocketGETupgrade with 405, which prevented Tailscale JS/WASM control clients from connecting #3359 - Gracefully handle nodes with an invalid FQDN (empty or too long) instead of failing map delivery; offending names are logged at startup with the fix command #3349
Upgrade
Please follow the steps outlined in the upgrade guide to update your existing Headscale installation.
Changelog
- [8eea89] CHANGELOG: drop unreleased 0.30.0 stub
- [f708c5] CHANGELOG: note /ts2021 WebSocket GET fix
- [735742] CHANGELOG: note 0.29.2 invalid-name map fix
- [3ac33c] CHANGELOG: shorten 0.29.2 invalid-name entry, set date
- [f885d8] Fix invalid ip syntax
- [1ec7b7] hscontrol: register /ts2021 for WebSocket GET
- [8f4e69] integration: add TS2021 WebSocket tests to CI matrix
- [e7851e] integration: test /ts2021 WebSocket GET with a real WASM client
- [9d1327] mapper,policy: add reconnect-storm and lock-concurrency regression tests
- [ec6719] mapper: skip peers with invalid names instead of failing the map
- [d4f2ac] policy: take RLock for reads so map generation runs concurrently
- [5fb76e] poll: return an HTTP error on long-poll setup failure
- [fd154f] state: log nodes with map-breaking data at startup
- [9c9206] state: reject renames whose FQDN exceeds the hostname limit
