Supported Home Assistant installations

Home Assistant add-ons require Home Assistant OS or Home Assistant Supervised. Home Assistant Container and Home Assistant Core installations cannot run add-ons.

This includes Home Assistant Green, Yellow, Raspberry Pi and other single-board computers running HAOS, ODROID, generic x86-64 boxes or NUCs, and HAOS virtual machines.

Install and pair

  1. Open Settings → Add-ons → Add-on Store.
  2. Open the ⋮ menu, choose Repositories, and add https://github.com/HomeTunnel/ht-home-assistant-addon.
  3. Install HomeTunnel™ from the add-on store and start it.
  4. Copy the time-limited pairing code shown by the add-on.
  5. In the Portal, open the home you own and enter or confirm the code.
Home Assistant add-on store menu with Repositories selected
Open the add-on store menu and choose Repositories.
Home Assistant add-on store showing the installed HomeTunnel Client add-on
HomeTunnel appears in its own add-on repository section.
Home Assistant add-on details showing HomeTunnel Client running with start on boot enabled
Start the add-on and enable start on boot before pairing.

Use one HAOS or Supervised routing device per home. The Portal provisions the isolated network automatically and gives the add-on a short-lived setup key; the add-on does not hold NetBird administrator credentials.