Matter / Thread troubleshooter
Find why your Matter or Thread device will not pair, appears unavailable, or misses entities
Select the device, target ecosystem, symptom, hubs, and controller state. The tool explains likely blockers, what to check before resetting, and the safest setup path.
Hubs or controllers you already have
Matter over Thread diagnosis
Aqara Door and Window Sensor P2
- No Thread Border Router selected for a Thread device.
- Home Assistant Matter setups need a controller path and Matter Server enabled.
- Add or select a Thread Border Router before pairing.
- Pair through Home Assistant using a Matter Controller.
- For Home Assistant, verify Matter Server, IPv6, mDNS, and controller availability.
- Test basic control first, then build automations.
- Confirm the Thread device is within range of a Thread Border Router.
- Confirm the target ecosystem has a Matter Controller commissioned and online.
- In Home Assistant, confirm the Matter integration and Matter Server add-on are running before pairing.
- Avoid factory resetting repeatedly. First confirm controller, border router, app, and network requirements.
- If the device works in a vendor app but not the target ecosystem, check whether the feature is exposed through Matter or only through the vendor integration.
Share or save this result
Copy the current setup URL or a concise diagnosis summary.
Feedback
Help improve this compatibility data
Smart home compatibility changes quickly. Send a report, request a missing device, or flag information that needs another review.
Save the setup path, missing hubs, limitations, and next steps for later.
Tell us which device, hub, or ecosystem should be added to the compatibility library.
Flag outdated, incomplete, or unclear setup guidance so it can be reviewed.
Get a practical checklist for hubs, Thread border routers, Matter pairing, and fallback paths.