Install OpenThread Border Router

Use this guide to install OpenThread Border Router on your Home Assistant instance when your system needs Thread support for Matter over Thread devices.

Before You Start

Before you install OpenThread Border Router, confirm:

1. Your Selora Box’s Home Assistant server is fully updated.
2. A Matter over Thread-capable radio dongle is connected to your SeloraBox PC.
3. You know the adapter’s expected baud rate from the manufacturer documentation.

Install the App

1. Open your Home Assistant instance.
2. Go to Settings > Apps.
3. Select + Install App.
4. Search for OpenThread Border Router.
5. Open the app page and review the documentation.
6. Select Install.
7. Wait for the installation to complete.
8. Enable Start on boot, Watchdog, and Auto-update.

Configure the Adapter

1. Connect a Matter over Thread adapter/dongle to your SeloraBox PC, if not already.
2. In Home Assistant, go to Settings > Apps > OpenThread Border Router, if not already.
3. Open the Configuration tab.
4. Under Device, select your Thread adapter listed by serial ID.
5. Enter the baud rate provided by the adapter documentation.
6. Save the configuration.

Start and Verify the App

1. In Settings > Apps > OpenThread Border Router, select Start.
2. Open the Log tab.
3. Confirm the app starts without repeated connection or serial errors.
4. Go to Settings > Devices & Services.
5. Confirm that Thread appears as an available or configured integration.
6. Open the Thread integration and confirm that a Thread network appears.

If you do not yet have a Thread network

If this is your first Thread network:

1. Open Settings > Devices & Services.
2. Open the Thread integration.
3. Select Configure.
4. Confirm that the Home Assistant Thread network appears.
5. Make Home Assistant the preferred network before pairing Matter over Thread devices.

If your home already has an existing Apple or Google Thread network:

1. Open the Thread integration.
2. Import the existing credentials first.
3. Make that existing network the preferred network.
4. Then continue with OpenThread Border Router and Matter setup.

Before moving on

Before pairing any Matter over Thread devices, confirm:

• OpenThread Border Router is installed and running.
• The correct Thread radio is selected.
• The app logs do not show repeated serial or startup failures.
• The Thread integration can see a Thread network.
• Your phone has the Home Assistant Companion App .
• Your phone is also set up to be a commissioner for Matter over Thread .