headscale v0.29.1 released on 18-06-2026
headscale v0.29.1 is out now. It raises the minimum supported Tailscale client to v1.80.0, so operators should ensure connected clients are upgraded to avoid compatibility issues.
Refer to the official upgrade guide at https://headscale.net/stable/setup/upgrade/ and the project release notes on GitHub for full details before updating.
What’s in this release
- Minimum supported Tailscale client version set to v1.80.0 — clients must be at or above this version.
- Fix for a migration bug that prevented nodes with tags=’null’ from keeping their assigned user; the database migration now preserves user_id for such untagged nodes (PR #3325, commit 636f660).
- Release changelog and upgrade guidance emphasise the compatibility requirement and the migration fix; follow the documented steps when updating.
Upgrade notes
- Compatibility action: upgrade all connected Tailscale clients to at least v1.80.0 before or when deploying headscale v0.29.1 to avoid compatibility issues.
- Follow the official upgrade guide at https://headscale.net/stable/setup/upgrade/ for detailed steps and further notes on the migration.
Share your experience after upgrading or report any issues on the project’s GitHub so others can benefit from your findings.
