Matter Server addon “Commission new WiFi device” and “Commission new Thread device” remain greyed out

[crafting-vision (CuiYuanze)]

I’m running Home Assistant OS 15.2 on a Raspberry Pi 5, connected via Ethernet. I have both the Matter Server add-on and the OpenThread Border Router (OTBR) add-on installed. Despite that, when I open Matter Server → Open Web UI → “＋ Commission node”, both of these entries are still disabled/greyed out.

I would like to know how to correctly execute the ‘Commission new WiFi device’ and ‘Commission new Thread device’ processes on a Raspberry Pi 5.

I have confirmed the RPi’s built-in Bluetooth adapter is powered on and working

My OTBR add-on is running and reporting a valid Thread network, And Set to preferred Thread network.

Steps to reproduce the issue

1. Install Home Assistant OS 15.2 on Raspberry Pi 5 (Ethernet).
2. Install homeassistant/addon matter_server (Matter Server 8.0.0).
3. Install homeassistant/addon openthread-border-router and flash a USB dongle with OpenThread RCP.
4. Verify OTBR is running with a valid Thread network (Pan ID, PSKc, Channel).
5. Reboot or restart both add-ons.
6. Navigate to Matter Server → Open Web UI → “＋ Commission node.”
7. Observe that “Commission new WiFi device” and “Commission new Thread device” remain greyed.

[vreihen]

You can only add new devices from the HA smartphone app. The feature is not available on the web…

[peterxian]

Commissioning new Matter devices requires Bluetooth, which is why a mobile device is usually the easiest way. It is possible to enable commissioning via the server / web interface, but the Matter Server add-on (i.e. docker container) needs exclusive access to a Bluetooth adapter on the machine. Naturally this means the device you’re commissioning also has to be a few feet away from your Matter server until it is fully commissioned. This post has some details on how to enable server-based commissioning:

Matter Pairing/Commissioning hints

If you are new to Matter, check the official Matter integration docs! Specifically read the Adding a Matter device to Home Assistant which walks you through all the steps necessary to add a device. This post adds some more information and other commissioning options if you have problems or you are seeking for other ways to commission devices. The recommended commissioning mode for Matter devices is currently through the official Home Assistant companion apps. Both, the Android…

[wmaker (Tommy Long)]

@crafting-vision

I would like to know how to correctly execute the ‘Commission new WiFi device’ and ‘Commission new Thread device’ processes on a Raspberry Pi 5.

Yeah those are greyed out because Matter Server doesn’t see a Bluetooth controller. But if interested, then follow what Peter suggested. I myself have very good success using this method. Just make sure your MoT device is near the BT controller when commissioning.

[merlinn31]

@wmaker

Yeah those are greyed out because Matter Server doesn’t see a Bluetooth controller. But if interested, then follow what Peter suggested. I myself have very good success using this method. Just make sure your MoT device is near the BT controller when commissioning.

I navigated to matter server addon web ui on my newest model iPhone and commission node still has WiFi and Thread options greyed out.

[wmaker (Tommy Long)]

As a check, did you configure a bluetooth adapter id in the Matter Server AddOn configuration tab?

[crafting-vision (CuiYuanze)]

Thank you—that did the trick! I hadn’t realized the Bluetooth Adapter ID field was hidden under “Show unused optional configuration options,” so I assumed it would just default to hci0. Once I expanded that section and set the adapter to 0, commissioning new wifi and thread device via the web UI all worked perfectly.