Upgrade an existing installation

An existing headscale installation can be updated to a new version:

Read the announcement on the GitHub releases page for the new version. It lists the changes of the release along with possible breaking changes.
Create a backup of your database.
Update headscale to the new version, preferably by following the same installation method.
Compare and update the configuration file.
Restart headscale.