some file

Upgrade Your Self-Hosted NetBird Installation

Check for Updates

The NetBird Dashboard displays an update indicator at the bottom of the left navigation menu when a new version is available:

update-available

You can also check the current version programmatically via the API (requires authentication):

curl 'https://your-netbird-domain/api/instance/version' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer <your-access-token>'

Example response:

{
    "dashboard_available_version": "2.28.0",
    "management_available_version": "0.64.1",
    "management_current_version": "0.64.0",
    "management_update_available": true
}

Check Release Notes

Before upgrading, review the release notes for any breaking changes or migration steps:

Management, Signal, and Relay are all part of the same repository and share the same version numbers.

Upgrade Steps

To upgrade NetBird to the latest version:

  1. Run the backup steps described in the backup section.
  2. Review the release notes (see above) for any breaking changes.
  3. Pull the latest NetBird docker images: 
    docker compose pull management dashboard signal relay
  4. Restart the NetBird containers with the new images: 
    docker compose up -d --force-recreate management dashboard signal relay

For upgrades from older versions (pre-v0.26.0), see the Legacy upgrade notes.

Get In Touch

Feel free to ping us on Slack if you have any questions.