headscale v0.29.1 released on 18-06-2026
headscale v0.29.1 is out now. Administrators upgrading headscale — especially those with nodes whose tags were recorded as the literal string ‘null’ — benefit because the database migration now preserves user_id on those untagged nodes and the release sets a new minimum Tailscale client version.
See the official upgrade guide at https://headscale.net/stable/setup/upgrade/ and the GitHub release for full details before updating.
What’s in this release
- Fix for nodes with tags=’null’ losing their assigned user on upgrade (PR #3325; commit 636f660caf3ca995fad5a9ed6f1b6b0578637b55).
- Minimum supported Tailscale client version set to v1.80.0 — clients must be v1.80.0 or newer.
- Small, targeted release with upgrade guidance and a changelog entry: db: preserve user_id on untagged nodes with tags=’null’.
Upgrade notes
- Minimum Tailscale client v1.80.0 is required; ensure fleet clients are upgraded to avoid incompatibility with headscale v0.29.1.
- Follow the upgrade guide: https://headscale.net/stable/setup/upgrade/ for step‑by‑step instructions when updating to v0.29.1.
Share any comments on your upgrade experience or issues encountered so others can benefit from what worked and what did not.
