Back to the overview

Thread in Home Assistant

thread part of Home Assistant since 2023.2

Local, polling Set up in the user interface

Connects Home Assistant with Thread-based devices and networks, enabling local communication and diagnostics. Typically used for monitoring network health, managing connected devices, and ensuring reliable mesh network performance.

Typical uses

  • Network health monitoring
  • Device management
  • Mesh network reliability
  • Diagnostics collection

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, polling – Talks to the device on your own network and asks for changes at regular intervals.
Setup
in the user interface
Kind
Online service
Installations
203,034 (29.7 % of the installations that share statistics)
Categories
Other
Provides
Diagnostics
Found automatically via
Network discovery (Zeroconf)
Maintained by
@home-assistant/core
Python packages
python-otbr-api==3.0.0, pyroute2==0.9.6

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for Thread.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Known issues and fixes

5 open issues and 11 bug fixes in the last twelve months are recorded for Thread in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.6.3.

Open

  • open The Thread panel stops showing the border router after about three minutes even though the network remains functional. Affects: SLZB-06 since June 23, 2026 · 5 reactions · 7 comments · #174547
  • open The Apple TV cannot be removed from serving as a border router. Affects: Apple TV since March 18, 2026 · 4 reactions · 11 comments · #165969
  • open Switching to a new preferred Thread network fails when an old network exists. since October 16, 2025 · 2 reactions · 20 comments · #154629
  • open Thread credentials cannot be transferred to an iPhone. since April 8, 2026 · 1 reaction · 20 comments · #167699
  • open The Thread integration does not work on Home Assistant instances using only IPv6. since January 21, 2026 · 0 reactions · 7 comments · #161398

Fixed

  • fixed in 2026.6.3 The preferred Thread border agent address was not updated when the OTBR reconnects. Fix #173508
  • fixed in 2026.3.2 The integration had compatibility issues with the OTBR API that were resolved by updating the library. Fix #165298
  • fixed in 2025.10.0 The Thread setup process would incorrectly stop when multiple flows were started at the same time. Fix #153048

Source: the issue tracker of Home Assistant, as of September 13, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.

Scroll to Top