jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-16 22:06:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Matter: merge duplicate troubleshooting sections (#37550)

Browse Source
This commit is contained in:
c0ffeeca7 2025-02-19 08:18:14 +01:00 committed by GitHub
parent 4162fe535f
commit 978c12ca45
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 21 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
source/_integrations/matter.markdown
View File

@ -218,9 +218,26 @@ While trying to add the Matter device, I get an error stating that *Matter is cu
This could mean that not all required Matter modules that are needed by the Home Assistant Companion App have been downloaded yet. Try the following steps: This could mean that not all required Matter modules that are needed by the Home Assistant Companion App have been downloaded yet. Try the following steps:
1. Wait up to 24 hours for the Google Play services to download the necessary Matter modules. 1. Wait up to 24 hours for the Google Play services to download the necessary Matter modules.
2. If this did not work, try reinstalling the Home Assistant Companion app. 2. Make sure the requirements listed in the [prerequisites](#prerequisites) are met. This includes meeting the minimum system requirements:
3. If this did not work, try installing the Google Home app. Technically this is not required, but it might trigger another installation attempt of the Matter modules. - **Android**:
4. Refer to this [Troubleshooting Guide from Google](https://developers.home.google.com/matter/verify-services). - Minimum version is 8.1. Ideally, update to the latest version.
- Use a regular, Google-account Android setup. No alternative Android versions.
- Make sure the play services are all up to date.
- **iPhone**:
- Have the iOS version 16 or higher
3. Home Assistant Companion app:
- Make sure you installed the (full) version, downloaded from the Play Store.
- Make sure it is the latest version.
- If you only just installed or updated the Home Assistant Companion app:
- Wait.
- It can take a while before the required components are installed in the background.
- Try again after 1 hour to ensure the installation is complete.
4. Verify your device meets all requirements to support Matter:
- On your Android device, go to **Settings** > **Google** > **Devices & Sharing**.
- There should be an entry there for **Matter devices**.
5. Reinstalling the Home Assistant Companion app.
6. Try (re-)installing the Google Home app. Technically, this is not required, but it might trigger another installation attempt of the Matter modules.
7. Refer to this [Troubleshooting Guide from Google](https://developers.home.google.com/matter/verify-services).
## Sharing a device from another platform with Home Assistant ## Sharing a device from another platform with Home Assistant
@ -390,20 +407,7 @@ This button will only be visible within the Home Assistant Companion App (so not
### When trying to commission using Android, I get an error "Matter is unavailable" ### When trying to commission using Android, I get an error "Matter is unavailable"
1. For Android, minimum version is 8.1. Ideally, update to the latest version. Refer to the steps under [Troubleshooting the installation](#troubleshooting-the-installation).
2. Use a regular, Google-account Android setup. No alternative Android versions.
3. Home Assistant Companion app:
- Make sure to install the (full) version, downloaded from the Play Store.
- Make sure it is the latest version.
4. To verify your device meets all requirements to support Matter, on your Android device, go to **Settings** > **Google** > **Devices & Sharing**.
- There should be an entry there for **Matter devices**.
5. Make sure the play services are all up to date.
6. If you only just installed or updated the Home Assistant Companion app:
- Wait.
- It can take a while before the required components are installed in the background. - Try again after 1 hour to ensure the installation is complete.
7. If the error persists, reinstall the Home Assistant Companion app.
8. Some users have reported that reinstalling the Google Home app fixed this issue for them.
9. For more information, refer to the [extended troubleshooting guide](https://developers.home.google.com/matter/verify-services) from Google.
### Unable to commission devices, it keeps giving errors or stops working randomly ### Unable to commission devices, it keeps giving errors or stops working randomly