Skip to main content

Thread setup (network and USB connection)

Thread setup for Home Assistant: two options

SLZB devices support two ways to run a Thread network with Home Assistant:

  • Option A —- “Thread to remote OTBR”: OTBR runs on Home Assistant (OTBR add-on)on, or, since Jan-2026, called "App"), SLZB works as a Thread RCP (radio).
  • Option B —- “Thread + OTBR running on device”: OTBR runs directly on the SLZB device, Home Assistant connects to it via REST API.

slzb-06-thread-otbr.jpg

Prerequisites

  • A server with Home Assistant installed and running (example: Raspberry Pi 4 with HAOS).
  • An SLZB device with a Thread-capable radio module.
  • The Matter device you want to connect (example: Eve Energy EU).
  • An Android or iOS smartphone.

AdditionalAdditional: requirements per option

  • Option A (Thread to remote OTBR): SLZBAvailable muston SLZB-06x and SLZB-06xU series. Can run Thread RCP firmware and be connected to HAover either via USB  or network (Serial-over-IP).
  • Option B (Thread + OTBR on device): Available on SLZB-06xU series only. OTBR requires IPv6 on your LAN (IPv6 will be force-enabled on the device when this mode is activated).

Step 1 —- Choose your setup option

Option A: “Thread to remote OTBR” (OTBR add-onon/app runs on Home Assistant)

Choose this if you want OTBR to run on Home Assistant.Assistant or other smart home systems. SLZB acts as a Thread RCP (radio only). This is the traditional setup, and supports USB or network connection.

Option B: “Thread + OTBR running on device” (OTBR runs on SLZB)

Choose this if you want OTBR to run directly on the SLZB device. Home Assistant connects via network API (<http://device-ip>:ip:8080), and you don’t need the OTBR add-on in HA.

Note: this is an initial (beta) integration and may have limitations or unexpected behavior.

Step 2 —- Set SLZB mode / firmware

Option A (Thread to remote OTBR): Flash / select Thread RCP mode

  • Your device must have an internet connection.
  • Go to Mode and select the "Thread RCPto /remote Matter-over-Thread radio mode (RCP)OTBR". The device will be reflashed; wait until the update completes.

Option B (Thread + OTBR on device): Enable OTBR on the device

  • Your device must have an internet connection.
  • Go to Mode and select “Thread + OTBR running on device”. The device will apply the required configuration and services.services and reboots.
  • OTBR REST API will be available at <http://device-ip>:ip:8080.

Step 3 —- Home Assistant software setup

3.1 Install and start Matter Server (required for both options)

  1. In Home Assistant go to Settings → Devices & Services.
  2. Click Add integration and search for Matter.
  3. Keep Use the official Matter Server Supervisor add-on enabled and click Submit.
  4. Wait until Matter Integration and Matter Server add-on are installed.
  5. Go to Settings → Add-ons → Matter Server and click Start. Recommended: enable Start on boot and Watchdog.

Step 4 —- Thread / OTBR setup in Home Assistant

Option A: OTBR add-on on Home Assistant

Install the OpenThread Border Router add-on and connect it to the SLZB radio (USB or network).

  1. Go to Settings → Add-ons → Add-on Store.
  2. Search for OpenThread Border Router and click Install.
  3. Open the add-on and go to the Configure tab.

 

Option A —- OTBR add-on with USB connection
  1. Switch the coordinator to USB connection mode (if applicable).
  2. Set OTBR add-on parameters:
  • Port: select your SLZB USB serial port.
  • Hardware flow control: No
  • Baud rate: 460800
  • Flash firmware: No (use pre-flashed RCP firmware)
  • Click Save
  1. Go to Info tab and click Start.
  2. Recommended: enable Start on boot and Watchdog.
Option A —- OTBR add-on with Network connection (Serial-over-IP)

Configure the OTBR add-on to connect to the SLZB network serial endpoint (example: 192.168.1.10:6638).

  • Enable Show unused optional configuration options.
  • Hardware flow control: No
  • Baud rate: 460800
  • Flash firmware: No (use pre-flashed RCP firmware)
  • Network Device: <slzb-ip>:6638
  • Click Save, then go to Info → Start

Option B: OTBR runs on the SLZB device (no OTBR add-on needed)

In this option, you do not install/use the OTBR add-on in Home Assistant. OTBR is already running on the SLZB device.

  • Make sure SLZB mode is set to “Thread + OTBR running on device”.
  • OTBR REST API address: <device-ip>:8080

Step 5 — Configure Home Assistant integrations (both options)

  1. Go to Settings → Devices & Services.
  2. Add (or confirm autodiscovery of) these integrations:
  • Thread
  • OpenThread Border Router

Notes:

  • If you use Option A, the “OpenThread Border Router” integration will typically use the OTBR add-on.
  • If you use Option B, when asked for the Border Router address, use: <device-ip>:8080.

In the Thread integration:

  • Set OpenThread Border Router as the Preferred network.
  • If available, enable Use router for Android + iOS credentials.

Step 6 — Reboot Home Assistant

  1. After installing and configuring Matter + Thread components, reboot your Home Assistant server.

Step 7 — Pre-set up your phone

  1. Install Home Assistant app on your phone.
  2. Install Google Home app (often required for Thread credential handling on Android).
  3. Open Home Assistant app and connect it to your Home Assistant server (same Wi-Fi network).
  4. In the app go to Settings → Companion app → Troubleshooting → Sync Thread Credentials.
  5. Repeat until you see: Home Assistant and this device use the same network.
  6. If it fails repeatedly, try resetting Google Play Services data (Android) and try again.

Step 8 — Add the Matter-over-Thread device

  1. Ensure Bluetooth is enabled on your phone.
  2. In Home Assistant app: Settings → Devices & Services → Devices.
  3. Tap + ADD DEVICE → Add Matter device.
  4. Scan the QR code (or enter the pairing code) and follow the on-screen steps.
  5. If prompted “Which app to open?”, choose Other → Home Assistant.

The pairing flow usually goes through:

  • Connecting to device…
  • Generating Matter credentials…
  • Connecting device to network…
  • Checking network connectivity…
  • Connecting device to Home Assistant…
  • Device connected!

Tips:

  • If the device was powered for a long time, you may need to reset it to enter pairing mode again.
  • If you have Google/Nest Thread devices and pairing is unstable, try turning them off temporarily while pairing.

Step 9 — Verify connection and control

  1. After pairing, the device should appear in Home Assistant under Devices.
  2. Open it and confirm you can control it (e.g., switch on/off).

Congratulations! You’ve successfully connected a Matter-over-Thread device to Home Assistant.

TIP:
Home Assistant Thread documentation:  https://www.home-assistant.io/integrations/thread/

---------------------------------------------------------------------------------------

Prerequisites

  • A server with Home Assistant installed and running. In this manual, we are using Raspberry Pi 4 with clean fresh install of HAOS.
  • An SLZB-06 or MR families Coordinator flashed with OpenThread Border Router firmware. In this manual, we use SMLIGHT SLZB-06 flashed with Thread RCP firmware. This is available in the Core firmware v2.1.0-dev and up.
  • The Matter device you want to connect (in this manual, we use the Eve Energy-EU socket).
  • An Android or IOS smartphone.

OpenThread Border Router firmware flashing

  • Your device must have an internet connection.
  • Go to the Mode section, select the Matter-over-Thread mode, the device will be reflashed, wait for the firmware update to complete.

Software set-up

  1. We'll need to install the OpenThread Border Router add-on in Home Assistant. Head over to the Left panel within Home Assistant and Click Settings and choose Add-ons.
  2. Navigate to the Add-on Store and search for OpenThread Border Router Add-on. Click Install and wait for the installation to complete.
  3. Once installed, click Configure tab on the top side of the add-on.

Setting Up the Thread Border Router Add-on (USB connection)

  1. Switch coordinator to USB mode.
  2. Make the following OTBR addon settings:
    - Port: choose port of your device. If you do not know which one, I recommend you to leave just once device in your USB ports and choose it.
     - Hardware flow control: No.
     - Baud rate: 460800.
     - Flash firmware: No (we use pre-flashed coordinator)
     - Click Save.
  1. Go back to the INFO tab and Start the OpenThread Border Router add-on. It may take a moment to initialize. We would suggest to activate both Start on boot and Watchdog.
  2. You can check logs, they should say that addon started, although they can contain some errors as Thread and Matter are still under development in Home Assistant.

Setting Up the Thread Border Router Add-on (Network connection)

  1. IMPORTANT: Due to config validation issues, you need to connect anyANY USB serial device to your HAOS so you can save the configuration.

    image.png


    Select USB device, this will allow you to save the configuration, after the addon is configured and the configuration is saved you can disconnect the USB device, the addon still will be able to run but if you need to change the configuration you will need to connect the USB device again.
  • Select Show unused optional configuration options
  • Hardware flow control: No.
  • Baud rate: 460800.
  • Flash firmware: No (we use pre-flashed coordinator)
  • Network Device: Enter the IP and port of your coordinator. (for example 192.168.1.10:6638)
  • Click Save.
  1. Go back to the INFO tab and Start the OpenThread Border Router add-on. It may take a moment to initialize. We would suggest to activate both Start on boot and Watchdog.
  2. You can check logs, they should say that addon started, although they can contain some errors as Thread and Matter are still under development in Home Assistant.

SettingOption UpB: OTBR runs on the MatterSLZB device (no OTBR add-on andneeded)

Integration

In this option, you do not install/use the OTBR add-on in Home Assistant. OTBR is already running on the SLZB device.

  • Make sure SLZB mode is set to “Thread + OTBR running on device”.

Step 5 - Configure Home Assistant integrations (both options)

  1. Go to the Home Assistant interface and navigate to Settings >→ Devices & Services.
  2. Click on Add integration(or andconfirm searchautodiscovery forof) Matter.
    3. these
  3. Keep checkbox Use the official Matter Server Supervisor add-on and click Submit.
  4. Wait untill installation of Matter Integration and Matter Server add-on is completed.
  5. Head over to the Left panel within Home Assistant and Click Settings and choose Add-ons. Go to the Matter Server add-on. Start the Matter Server add-on. Here we would suggest as well to click both Start on boot and Watchdog.

Set-up and configuring the Integrations

  1. Now, let's install the required integration: Thread and OpenThread Border Router.
  2. Go back to the Home Assistant interface and navigate to Settings > Devices & Services.
  3. Basically, all two should be autodiscovered so you just need to configure them. If they are not, click on Add integration and search for them there.
  4. OpenThread Border Router – no configurations, just add.
  5. Thread Integration – click Configure and make sure you have OpenThread Border Router under Preferred network line, and it contains an icon with key+phone. If not, do the following:integrations:
  • clickThread
    • three dots on the right to 
  • OpenThread Border Router

Notes:

  • If you use Option A, choosethe Add“OpenThread toBorder preferredeRouter” networkintegration will typically use the OTBR add-on.
  • If you use Option B, when asked for the Border Router address, use: <device-ip>:8080.
  • Under

In the preferredThread networkintegration:

now,
    click
  • Set again three dots on the right to OpenThread Border Router, andas choosethe Preferred network.
  • If available, enable Use router for Android + iOS credentials.
  1. Start the add-on. Here we would suggest as well to click both Start on boot and Watchdog.

Step 6 - Reboot your Home Assistant server

  1. OnceAfter allinstalling Homeand Assistantconfiguring componentsMatter are+ installed,Thread we reccomend tocomponents, reboot your Home Assistant server.

Step 7 - Pre-set up your phone

  1. Install Home Assistant app on your Android phone from Play store. At the time of this video, we were unable to pair Matter-over-Thread device via iPhone.phone.
  2. Install Google Home app from(often Playrequired store. It is recommended by Home Assistant developers and we were not able to pair ourfor Thread devicescredential withouthandling installedon Google Home app.Android).
  3. Open Home Assistant app and syncconnect it withto your Home Assistant server. Your phone and Home assistant server should be in the (same Wi-Fi network.network).
  4. In app,the app go to Settings –→ Companion app -> Click→ Troubleshooting and click→ Sync Thread Credentials.
  5. WaitRepeat until messageyou see: Home Assistant and this device use the same network. If you see another message, namely Added network from Home Assistant to this device – you need to click on Sync Thread Credentials again, until you get that message about the same network.
  6. If youit arefails not getting message Home Assistant and this device use the same network -repeatedly, try to reset yourresetting Google Play Services (remove all data, usually by App settings -> Erase data ->(Android) Clearand Alltry Data, but namings depend on the smartphone model).again.

AddingStep 8 - Add the MatterMatter-over-Thread Devicedevice

  1. With the Matter integration set up, grab your Matter device and Android smartphone. Make sureEnsure Bluetooth is enabled on your phone.
  2. Open theIn Home Assistant app and navigate toapp: Settings >→ Devices & Services ->→ Devices Tab..
  3. Click theTap + ADD DEVICE button at the borrom right part of the screen to add a device, choose→ Add Matter device.
  4. FollowScan the QR code (or enter the pairing code) and follow the on-screen instructions in the app. You'll likely need to scan a QR code located on your Eve Energy socket or enter pairing code manually. We did it with QR-code scanning.steps.
  5. HomeIf Assistanprompted app on your phone can as “Which app to open?”, Selectchoose otherOther and then→ Home assistantAssistant.

The app will guide you through pairing theflow deviceusually withgoes your Thread network. It should pass through this satuses: through:

  • Connecting to device...device…
  • Generating Matter credentials...credentials…
  • Connecting device to network...network…
  • Checking netwoeknetwork connectivity...connectivity…
  • Connecting device to Home Assistant...Assistant…
  • Device connected!
  1. Note:

Tips:

  • If athe Matter-over-Thread end-device has beenwas powered up for a long time, ityou may requireneed ato reset of deviceit to put back intoenter pairing mode.mode again.
  • In caseIf you have GoogleGoogle/Nest homeThread devices (Nest hub) and experiancespairing issuesis with pairing,unstable, try to turnturning them off beforetemporarily startingwhile OpenThreadpairing.
    • Border
router
add-on

Step on9 your- Verify connection and control

  1. After pairing, the device should appear in Home Assistant and your Home Assistant app.

    2. Verifying Connection and Control

    1. Once the pairing is complete, head back to the Home Assistant interface. You should see your Eve Energy socket listed on your Dashboard or under the Devices section .
    2. ClickOpen on the device to access its controls. You should be able to turn the socket onit and offconfirm remotelyyou withincan thecontrol Homeit Assistant(e.g., interface.switch on/off).

    CongratulationsCongratulations!! You'You’ve successfully connected youra Matter-over-Thread device to Home Assistant using the OpenThread Border Router and Matter Integrations. Now you can enjoy the benefits of Matter's secure and interoperable smart home ecosystem.Assistant.

    TIP:
    You can refer to the Home Assistant documentation for Matter and Thread for more troubleshooting stepsdocumentation:  https://www.home-assistant.io/integrations/thread/ 

Back to top