OpenThread Border Router

OpenThread Border Router (OTBR) bridges a Thread mesh network to your local Wi-Fi or Ethernet network using a Thread radio dongle, letting Home Assistant and…

  • Automation
  • Home Automation
  • Tools & Utilities
OpenThread Border Router (OTBR) bridges a Thread mesh network to your local Wi-Fi or Ethernet network using a Thread radio dongle, letting Home Assistant and Matter-over-Thread devices such as locks, sensors, plugs, and thermostats join your smart home stack without a vendor-specific hub like Apple HomePod, Google Nest Hub, or Amazon eero.

Platform availability

Available on 2 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

73/100 Good

Maintained
100last commit 14 days ago
Popular
55584 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
82no serious findings, 2 minor, CI, tests, OpenSSF Scorecard 7.3/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 16 days ago

GitHub stars
584
Open issues
42
Last commit
2026-11-07
Latest release
v2026.11.0
License
BSD-3-Clause
Activity
steady

Checked 13 days ago - source: GitHub (openthread/ot-br-posix)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set up the Thread dataset first Before starting Thread, initialize and commit a dataset (the saved network setup) with the channel, network name, and network key. Without it, the border router will not form or join a Thread network correctly. source
  • Save the network key and PSKc Write down the Network Key and PSKc (a pre-shared key for adding new devices) shown after creating the dataset, and keep them somewhere safe. You need these to add other devices later, and if they are lost you may have to rebuild the network. source
  • Bring up the interface and start Thread After committing the dataset, run ifconfig up and thread start, then check that state says leader or router. This turns on the device’s networking and starts Thread; skipping it leaves the node idle instead of forming or joining the network. source
  • Setup Plug a Thread radio dongle into the device, open the app, and let the setup wizard detect the radio's serial device, confirm the backbone network interface, and verify IPv6 is available on the host and LAN. After saving, the border router starts automatically. Then add the OpenThread Border Router integration in Home Assistant using the REST API URL shown in the app. source

Fetched 39 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What should be configured and saved when setting up the Thread dataset for OpenThread Border Router?

Initialize and commit a dataset with the channel, network name, and network key, then save the Network Key and PSKc. If those keys are lost, you may have to rebuild the Thread network.

Why might Home Assistant report that no Thread border routers were found?

A SLZB Ultima configured as an OpenThread Border Router can show a no border routers were found error in Home Assistant even when the TLV and endpoint details match.

What Docker networking issue has been reported with OpenThread Border Router?

Running OTBR in a Docker container on a custom network has been reported to prevent apps such as Google Home from connecting.

Answers sourced from community.home-assistant.io, github.com, www.reddit.com

Community

Collected 16 days ago - public community threads