Back to the overview

Thread in Home Assistant

thread part of Home Assistant since 2023.2

Local, polling Set up in the user interface

The Thread integration connects Home Assistant with Thread-based networks, enabling local monitoring and diagnostics. It uses polling to check network status and is set up via the user interface with automatic discovery. Typically used for troubleshooting connectivity and ensuring device communication reliability.

Typical uses

  • Monitor network health
  • Troubleshoot connectivity
  • Ensure device communication
  • Integrate with Thread devices

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
215,484 (30.0 % 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.1.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

7 open issues and 10 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 when using an external OTBR device, though the network remains functional Affects: SMLIGHT SLZB-06M since June 23, 2026 · 5 reactions · 10 comments · #174547
  • open It is not possible to remove an Apple TV device that is acting as a border router Affects: Apple TV since March 18, 2026 · 4 reactions · 11 comments · #165969
  • open Thread credentials cannot be transferred to an iPhone device since April 8, 2026 · 2 reactions · 22 comments · #167699
  • open Switching to a new preferred Thread network may fail after attempting to delete an old one since October 16, 2025 · 2 reactions · 20 comments · #154629
  • open The Thread integration does not work on Home Assistant instances that only use IPv6 since January 21, 2026 · 0 reactions · 9 comments · #161398
  • open Sending Thread credentials to an iPhone device fails since October 7, 2026 · 0 reactions · 3 comments · #184776
  • open Changing the Thread channel through the user interface has no effect and the OTBR does not receive updates since September 26, 2026 · 0 reactions · 1 comment · #183246

Fixed

  • fixed in 2026.6.3 The preferred Thread border agent address is not updated when the OTBR reconnects Fix #173508
  • fixed in 2026.3.2 An outdated version of the python-otbr-api library was being used Fix #165298

Source: the issue tracker of Home Assistant, as of October 25, 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