Your device requires a Thread border router

I am setting up my Home Assistant for devices using Matter over Thread.

  • Installation method Home Assistant OS
  • Core 2026.6.1
  • Supervisor 2026.05.1
  • Operating System 17.3
  • Frontend 20260527.4

Home Assistant (HA) is hosted in Virtual Machine on my UGREEN NAS and is accessible.

Virtual machine was setup using this virtual disk (https://github.com/home-assistant/operating-system/releases/download/17.3/haos_ova-17.3.qcow2.xz)

ZBT-2 is connected to UGREEN NAS and is showing up in HA.

Using HA on android phone.

For some reason I am unable to add IKEA matter devices to it.

To me it seems like Matter Addon service does not know how to communicate to my OTBR.

I have "Set Thread credentials" manually via UI to Active dataset TLVs (is that ok?)

If I "Send credentials" from my Android Home Assistant, it says I don't have any credentials to send.

How to diagnose this? Any suggestions?

Thank you very much!

Matter

Matter addon is shown and is reporting "Online" status (Otherwise I do not see AddOns in left navigation)

{
  "home_assistant": {
    "arch": "x86_64",
    "dev": false,
    "docker": true,
    "hassio": true,
    "installation_type": "Home Assistant OS",
    "os_name": "Linux",
    "os_version": "6.12.85-haos",
    "python_version": "3.14.5",
    "timezone": "Europe/Belgrade",
    "version": "2026.6.1",
    "virtualenv": false,
    "container_arch": "amd64",
    "supervisor": "2026.05.1",
    "host_os": "Home Assistant OS 17.3",
    "docker_version": "29.3.1",
    "chassis": "vm",
    "run_as_root": true
  },
  "custom_components": {},
  "integration_manifest": {
    "domain": "matter",
    "name": "Matter",
    "after_dependencies": [
      "bluetooth",
      "hassio"
    ],
    "codeowners": [
      "home-assistant/matter"
    ],
    "config_flow": true,
    "dependencies": [
      "websocket_api"
    ],
    "documentation": "https://www.home-assistant.io/integrations/matter",
    "integration_type": "hub",
    "iot_class": "local_push",
    "requirements": [
      "matter-python-client==0.7.1",
      "matter-ble-proxy==0.7.1"
    ],
    "zeroconf": [
      "_matter._tcp.local.",
      "_matterc._udp.local."
    ],
    "is_built_in": true,
    "overwrites_built_in": false
  },
  "setup_times": {
    "null": {
      "setup": 0.001601418000063859
    },
    "01KTHGEWQAPW9ZY0DM3YQVA9AP": {
      "wait_import_platforms": -0.00012393599899951369,
      "config_entry_setup": 0.01632594300463097
    }
  },
  "data": {
    "server": {
      "info": {
        "fabric_id": 2,
        "compressed_fabric_id": 13776322074381142841,
        "schema_version": 11,
        "min_supported_schema_version": 9,
        "sdk_version": "2025.7.0",
        "wifi_credentials_set": false,
        "thread_credentials_set": true,
        "bluetooth_enabled": false,
        "wifi_ssid": null,
        "ble_proxy_enabled": false
      },
      "nodes": [],
      "events": []
    }
  },
  "issues": []
}

Thread (OTBR)

Network name: ha-thread-1174
Channel: 15
Dataset ID: 01KTH8BRHBDR62PX61WS6T4ZFD
PAN ID: 1174
Extended PAN ID: 4c7b484ddcc4d227
OTBR URL: http://core-openthread-border-router:8081
Active dataset TLVs: xxxxxxx

When I try to download diagnostics it reports 404

Looks like there’s a problem with this site

The server at 192.168.0.44:8123 sent back an error: 404 Not Found

Adding device Fails

There is a step many miss or misunderstand and that is copying the credentials from HA to the phone.

On the phone...

  • Open the Companion app
  • Open the settings menu
  • Select Companion app
  • Select Troubleshooting (Look from the bottom to find it fast)
  • Click Sync Thread credentials
1 Like

Wow. Not exactly obvious setup.

I've managed to connect my first IKEA sensor!

You rock!

Thank you dear sir,
Tom

Mine (iOS) doesn't have a Troubleshooting menu. There's "Debugging", but it doesn't have "Sync Thread credentials". It does have "Thread", which has "Apple Keychain", which has "Transfer to Home Assistant". Is that... the same?

Are you on the phone and in the companion app?

I am not familiar with the iPhone app, but it should say copy from HA and not the other way around.