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…
Platform availability
Available on 2 of 10 platforms
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
Variants
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
- Suggestions for a tiny&dedicated OpenThread Border Router? (other)
- Thread: "No border routers were found. Check your border router is ... (other)
- Using openwrt as openthread border router (forum)
- Compiling & Installing openthread-br package for openWrt on Pi 4 model B (forum)
- Running OTBR in Docker - Home Assistant Community (other)
- Running Matter/Thread (with an external OTBR) alongside Home Assistant ... (other)
Collected 16 days ago - public community threads