home-assistant / home-assistant/android

Matter/Thread cannot pair in companion app with HA as Border Router: Your device requires a Thread Border Router

Open
#5,805 10 comments 6 reactions 0 assignees View on GitHub
bug
Dominant language
Kotlin
Stars
3.9k
Forks
1.1k
Avg merge
1d 12h
Merged PRs (30d)
81

Description

**Home Assistant Android app version(s):**
2025.8.7-full
**Android version(s):**
Android 16
**Device model(s):**
Pixel 10 Pro
**Home Assistant version:**
Home Assistant Yellow
Core 2025.9.3
Supervisor 2025.09.0
Operating System 16.2
Frontend 20250903.5

**Description of problem, include YAML if issue is related to notifications:**
Apparently, during the pairing process, the phone may not have the Thread Credentials that are needed for pairing. The pairing process errors out with an EXTREMELY unhelpful: “Your device requires a Thread border router”, while the Home Assistant IS the Thread Border Router.

Suggested Fixes:
Fix A) Make it so that the credentials are synced whenever someone tries to pair Matter/Thread automatically?
Fix B) Don’t display “Your device requires a Thread Border Router” when OTBR is configured/preferred?

**Screenshot or video of problem:**
Image

**Additional information:**
The following forum posts are filled with frustrated users due to this issue:
https://community.home-assistant.io/t/thread-border-router-required-error-when-setting-up-matter-device-on-ios-app/765161/24
https://community.home-assistant.io/t/pure-ha-thread-border-router-required/691120/39
https://community.home-assistant.io/t/solved-broken-haos-thread-border-router-setup-with-skyconnect/683707/20
https://community.home-assistant.io/t/thread-border-router-required-with-eve-and-matter/562937/122

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.