home-assistant / home-assistant/android
Matter/Thread cannot pair in companion app with HA as Border Router: Your device requires a Thread Border Router
- 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:**
**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
Assessment
This issue has not been assessed yet.