This article explains how to add a Matter device to Homey Pro, Homey Pro mini, or Homey Self-Hosted Server. The steps depend on which product you use, so find your setup below.
Supported devices
Homey Pro, Homey Pro mini, and Homey Self-Hosted Server use Matter 1.5, which is backward compatible with older Matter versions. Homey supports the following device types:
Climate
- Air conditioners
- Air purifiers
- Fans
- Heat pumps
- Thermostats
Kitchen and laundry
- Cooktops
- Dishwashers
- Extractor hoods
- Microwave ovens
- Ovens
- Refrigerators and freezers
- Laundry washers
- Laundry dryers
Lighting, power, and access
- Lights
- Sockets, including sockets with energy monitoring
- Buttons
- Locks
Energy
- EV chargers
- Solar panels
- Water heaters
- Water valves
- Pumps
Sensors
- Motion and 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
Home and entertainment
- Bridges (only bridged devices of the types listed here can be used in Homey)
- Robot vacuum cleaners
- Speakers
- Video players
- Window coverings
Homey adds new device types as they’re released and added to the Matter specification.
Matter-over-Thread
Homey Pro connects to Matter-over-Thread devices using its own built-in Thread network. On Homey Pro mini and Homey Self-Hosted Server, pairing a Matter-over-Thread device always goes through your phone’s Thread network.
Homey Self-Hosted Server needs a Thread Border Router already on your network to use Matter-over-Thread devices. See “Add a device on Homey Self-Hosted Server” below.
If Homey Pro only has an Ethernet connection, select a Wi-Fi network manually when you connect the device.
Requirements
- Homey Pro firmware v10.3.0 or newer, to set up devices through the Homey Web App
- Homey Mobile App v9.2.5 or newer
- iOS 18.5 or newer, or Android 8 or newer with the latest Google Play Services
- Homey Self-Hosted Server: a Thread Border Router on your local network, to add Matter-over-Thread devices
Add a device through the Homey Web App
Use this method on Homey Pro. Adding a Matter-over-Thread device this way always uses Homey Pro’s own Thread network.
1. Go to my.homey.app and sign in.
2. Click the plus icon, then click New Device.
3. Click Homey, then click Matter.
4. Follow the on-screen instructions.
Add a device through the Homey Mobile App
Use this method on Homey Pro or Homey Pro mini.
1. Open the Homey Mobile App and tap Devices.
2. Tap the plus icon, then tap New Device.
3. Tap Matter under Technologies.
4. On Homey Pro, choose Connect via Homey Pro or Connect via Android/iOS. Homey Pro mini skips this step and always pairs through your phone.
Connect via Homey Pro uses Homey Pro’s own Thread network and works for most setups. Homey Pro uses Bluetooth to make the initial connection to the device, then switches to Thread or Wi-Fi once the device joins the network. Keep the Matter device near Homey Pro while connecting. A Matter-over-Wi-Fi device joins the same Wi-Fi network as Homey Pro.
Connect via Android/iOS uses your phone’s Thread network instead, and your phone makes the Bluetooth connection, so keep the device near your phone while connecting. A Matter-over-Wi-Fi device joins the same Wi-Fi network as your phone.
See Thread on Homey for more on Thread.
5. Follow the on-screen instructions.
Add a device on Homey Self-Hosted Server
Matter-over-Thread devices on Homey Self-Hosted Server need a Thread Border Router already running on your network.
- Add and set up a Thread Border Router, using the manufacturer’s app.
- In the Homey Mobile App, go to More (…) → Settings → Thread to check if a Thread Border Router is available on your network.
- Go to Devices, tap the plus icon, then tap New Device, then tap Matter.
If no Thread network appears in step 2, your phone may not be on the same network as the Thread Border Router. Connect to the same network and check again.
Homey doesn’t create its own Thread network on Homey Self-Hosted Server. When you set up a Thread Border Router, its manufacturer’s app, such as Apple Home, Google Home, or Alexa, syncs the Thread credentials to your phone. Homey uses those same credentials to add devices to the existing Thread network.
Known issues
Some Android phones don’t pair with Matter devices even with the required Android and Google Play Services versions installed. The Matter API in Google Play Services can take up to 24 hours to update. If pairing fails, wait a day and try again before contacting support.
