Connecting Home Assistant to my network with the Netbird add-on

Community Support Self-Hosted
1

Setup Netbird and managed to bring all of my peers online except for Home Assistant and wanted help in figuring out where I’m going wrong.

Here are some details about the Netbird add-on running on Home Assistant.

App version: v0.64.4
You are running the latest version of this app.
System: Home Assistant OS 17.0  (amd64 / qemux86-64)
Home Assistant Core: 2026.1.3
Home Assistant Supervisor: 2026.01.1

Once I’ve filled in all the requisite configuration options and start the add-on, the add-on quits with the following errors:

s6-rc: info: service base-addon-banner successfully started
s6-rc: info: service fix-attrs: starting
s6-rc: info: service base-addon-log-level: starting
s6-rc: info: service fix-attrs successfully started
s6-rc: info: service base-addon-log-level successfully started
s6-rc: info: service legacy-cont-init: starting
s6-rc: info: service legacy-cont-init successfully started
s6-rc: info: service netbird: starting
s6-rc: info: service netbird successfully started
s6-rc: info: service legacy-services: starting
s6-rc: info: service legacy-services successfully started
[08:45:13] INFO: Using https://my.domain.name as Admin URL
[08:45:13] INFO: Using https://my.domain.name as Management URL
[08:45:13] INFO: Setup Key configured (hidden for security)
[08:45:13] INFO: Using homeassistant as hostname
[08:45:13] INFO: Rosenpass disabled
[08:45:13] INFO: No log level Set
[08:45:13] INFO: This client will use the default logging.
[08:45:13] INFO: Starting NetBird Client...
[08:45:13] INFO: netbird up  --foreground-mode --config /config/config.json --log-file console --admin-url https://vpn.low-key.me --management-url https://my.domain.name --setup-key MY-SETUP-KEY --hostname homeassistant --enable-rosenpass=false
2026-02-02T08:45:13+05:30 INFO client/internal/profilemanager/config.go:238: new Management URL provided, updated to "https://my.domain.name" (old value "https://my.domain.name:443")
2026-02-02T08:45:15+05:30 ERRO shared/management/client/grpc.go:516: failed to login to Management Service: rpc error: code = PermissionDenied desc = no peer auth method provided, please use a setup key or interactive SSO login
Error: foreground login failed: login check failed: rpc error: code = InvalidArgument desc = invalid setup-key or no sso information provided, err: invalid UUID length: 0
[08:45:15] INFO: Service NetBird Client exited with code 1 (by signal 0)
s6-rc: info: service legacy-services: stopping
s6-rc: info: service legacy-services successfully stopped
s6-rc: info: service netbird: stopping
s6-rc: info: service netbird successfully stopped
s6-rc: info: service legacy-cont-init: stopping
s6-rc: info: service legacy-cont-init successfully stopped
s6-rc: info: service fix-attrs: stopping
s6-rc: info: service base-addon-log-level: stopping
s6-rc: info: service fix-attrs successfully stopped
s6-rc: info: service base-addon-log-level successfully stopped
s6-rc: info: service base-addon-banner: stopping
s6-rc: info: service base-addon-banner successfully stopped

How can I go about troubeshooting this?

2

You need to pass a setup key generated in the netbird UI to the homeassistant add-on/app. See the configuration tab in th add-on page.

3

That’s exactly what I’m doing and why I’m confused about what’s going wrong.

4

I set the following options:

  • Admin Panel URL
  • Management URL (same as admin panel URL for me)
  • Setup Key
  • Hostname

Note, that a setup key can only be used once (if not configured otherwise) and is only valid for a certain time. You can see in the dashboard, if the key is still available.

(since the setup key is used I should be able to delete it in the configuration, but I have not tried).

Works for me.

Home Assistant on RasberryPI.

5

Those are the options I’m setting too but the setup key doesn’t get used and I instead get the error reported above.

I uninstalled and reinstalled the add-on and also tried after rebooting Home Assistant itself but still get the same results.

6 
[08:45:13] INFO: netbird up  --foreground-mode --config /config/config.json --log-file console --admin-url https://vpn.low-key.me --management-url https://my.domain.name --setup-key MY-SETUP-KEY --hostname homeassistant --enable-rosenpass=false
2026-02-02T08:45:13+05:30 INFO client/internal/profilemanager/config.go:238: new Management URL provided, updated to "https://my.domain.name" (old value "https://my.domain.name:443")
2026-02-02T08:45:15+05:30 ERRO shared/management/client/grpc.go:516: failed to login to Management Service: rpc error: code = PermissionDenied desc = no peer auth method provided, please use a setup key or interactive SSO login
Error: foreground login failed: login check failed: rpc error: code = InvalidArgument desc = invalid setup-key or no sso information provided, err: invalid UUID length: 0
[08:45:15] INFO: Service NetBird Client exited with code 1 (by signal 0)

It looks like your management URL is pointed to the wrong location (or you modified the log to hide the details).
As you can see from my setup, my admin-url and management-url are the same except for the port. Also as stated in previous comments, ensure your key is still able to be used by checking your admin page and seeing the key has uses left or create a new key.

image
image1038×1030 66.4 KB