Skip to content

HA Add Matter WiFi Device

guoping.liu edited this page Aug 13, 2026 · 1 revision

How to Add a Matter over WiFi Device to LinuxBox

Currently, Matter over WiFi devices can be added via the Home Assistant App or via the Python Matter Server WebView.

Add via Home Assistant App

  1. The app can automatically discover Home Assistant on the local network.
  2. If you have previously connected to another HA instance, delete the old configuration first.
  3. In the app, go to Menu → Settings → Devices & Services → Add Integration → Add Matter device → "No, it's new".
image
  1. Put the Matter device into pairing mode (follow the device's own instructions).
  2. Choose "Open Camera here" or "Setup without QR code" to add the device.
image
  1. Follow the app prompts to complete device addition.

Add via WebView (Advanced)

⚠️ This is not a standard method and may not work for all Matter devices. If it fails after one retry, use the Home Assistant App instead.

  1. In your browser, enter http://<ip_address>:5580 to access the Python Matter Server.
  2. Click "Commission node" → "Commission new WiFi device".
  3. For the first operation, enter the SSID and password of the WiFi network.
image
  1. Put the Matter device into pairing mode.
  2. Enter the device's manual code and click "Commission".
image
  1. Wait for commissioning to complete.

Clone this wiki locally