This guide explains how to use Matter on Homey Pro, Homey Pro mini and Homey Self-Hosted Server.
Supported devices
Homey Pro and Homey Pro mini currently use Matter 1.5, which is backwards compatible with older Matter versions. The following Matter devices are supported.
- Air Conditioners
- Air Purifiers
- Bridges
- Only bridged devices of the types listed here can be used in Homey
- Buttons
- Cooktops
- Dish Washers
- EV Chargers
- Extractor Hoods
- Fans
- Heat Pumps
- Laundry Dryers
- Laundry Washers
- Lights
- Locks
- Microwave Ovens
- Ovens
- Pumps
- Refrigerators and Freezers
- Robot Vacuum Cleaners
- Sensors
- Motion & Presence: contact, occupancy, light
- Environment: temperature, pressure, humidity, flow
- Safety: smoke, CO, water leak
- Air Quality: CO2, NO2, O3, NCI, PM1, PM2.5, PM10, radon, TVOC
- Sockets
- Including sockets with energy monitoring
- Solar Panels
- Speakers
- Thermostats
- Video Players
- Water Heaters
- Water Valves
- Window Coverings
More devices will be added as they become available in the Matter specification and when products in that category are released.
Matter-over-Thread
Homey Pro and Homey Pro mini can connect to Matter-over-Thread devices. If you would like more information about Thread, you can take a look at this article.
How to use Matter
Matter devices can be added through the Homey Web App or Homey Mobile App on Homey Pro. For Homey Pro mini, use the Homey Mobile App to set up your devices.
The Homey Web App will connect Matter-over-Thread devices to Homey Pro’s Thread network. Matter-over-Wi-Fi devices will connect to the same Wi-Fi network as Homey Pro.
If Homey Pro is not connected to Wi-Fi and only uses an Ethernet connection, it is necessary to select a Wi-Fi network when manually connecting the Matter device.
No need to install apps
Homey Pro determines the device’s capabilities without installing any apps. However, Homey apps can improve the experience for Matter devices in Homey.
Homey Web App
If you’re using Homey Pro, you can follow these steps to connect a Matter device through the Homey Web App.
Requirements
Ensure Homey Pro is updated to v10.3.0 or newer before connecting your Matter device to Homey.
Step 1
Go to https://my.homey.app and sign in to your Homey account.
Step 2
Once signed in, click on → New Device in the upper-right corner.
Step 3
Click on Homey, then click on Matter.
Step 4
Follow the on-screen instructions. If everything goes successfully, the Matter device will be added to Homey Pro. If not, please refer to this article for more information.
Homey Mobile App
If you’re using Homey Pro or Homey Pro mini, you can follow these steps in the Homey app to connect a Matter device.
Requirements
Ensure the Homey app is updated to v9.2.5 or newer, and that your device runs iOS 18.5+ or Android 8+ with the latest Google Play Services.
Step 1
Open the Homey app and tap Devices in the tab bar.
Step 2
Tap → New Device in the upper-right corner.
Step 3
Tap Matter in the Technologies section.
Step 4
Follow the on-screen instructions. On Homey Pro, you’ll first be asked whether to connect via Homey Pro or iOS/Android, which determines the Thread network for Matter-over-Thread devices.
- Connect via Homey Pro: This option is advised for most users, as it always uses Homey Pro’s own Thread network.
- Connect via Android/iOS: This option uses the mobile device’s Thread network to connect to the Matter device.
If you’re using Homey Pro mini, this screen won’t appear. Pairing is always done via your iOS or Android device.
If everything goes successfully, the Matter device will be added to Homey Pro. If not, please refer to this article for more information.
Known issues
Some Android devices may not pair with Matter devices, even when the required Android and Google Play Services versions are installed. Please note that the Matter API of Google Play Services may take up to 24 hours to update.
