How to Add Shelly to Apple Homekit (2026 Setup Guide)
Shelly devices can work with Apple Home, but the setup method depends on the generation you have. Gen4 devices support Matter out of the box, while select Gen3 models can use Matter after a firmware update. Older Gen1 and Gen2 devices need a bridge such as Homebridge.
In this guide, we'll show you how to identify your Shelly generation, choose the right connection method, and add your devices to Apple Home step by step. You may also see Apple Home referred to as HomeKit throughout the guide.
The best setup method depends on your Shelly generation. Gen4 and Matter-supported Gen3 devices can connect directly to Apple Home using Matter. Gen1 and Gen2 devices need a bridge such as Homebridge. ATH Bridge is an easier option if you want to use Homebridge without setting up and maintaining your own Raspberry Pi or server.
Which Shelly Devices Work with Apple Home?
Shelly Wi-Fi devices from different generations can work with Apple Home, but the connection method is not the same for every model.
You can usually identify the generation from the product name. Gen3 and Gen4 devices include “Gen3” or “Gen4” in their names. Plus and Pro models belong to Gen2, while older models such as the original Shelly 1 and Shelly 2.5 are Gen1.
| Shelly Generation | Matter Support | Apple Home Setup | Example Models |
|---|---|---|---|
| Gen4 | Built-in | Matter or Homebridge | Shelly 1 Gen4, Shelly 1PM Gen4, Shelly 1 Mini Gen4, Shelly 1PM Mini Gen4 |
| Gen3 | Available on select models with firmware 1.6+ | Matter on supported models or Homebridge | Shelly 1L Gen3, Shelly 2L Gen3, Shelly Plug M Gen3, Shelly Outdoor Plug S Gen3 |
| Gen2 (Plus) | No | Homebridge, Home Assistant, or custom firmware | Shelly Plus 1, Shelly Plus 1PM, Shelly Plus 2PM, Shelly Plus Plug S |
| Gen2 (Pro) | No | Homebridge or Home Assistant | Shelly Pro 1, Shelly Pro 2PM, Shelly Pro 4PM |
| Gen1 | No | Homebridge, Home Assistant, or custom firmware | Shelly 1, Shelly 1PM, Shelly 2.5, Shelly Plug S, Shelly RGBW2, Shelly Dimmer 2 |
Note: Not every Gen3 model supports Matter. Check Shelly’s Matter-compatible product list for your exact model before using the Matter setup method.
This guide focuses on Shelly Wi-Fi relays, plugs, and dimmers. Shelly BLU and Shelly Wave devices use different integration methods and are not covered here.
Which Shelly Setup Method Should You Use?
The best setup method depends on your Shelly generation and the system you already use.
- Gen4 or Matter-supported Gen3: Use Matter for a direct connection to Apple Home without a bridge.
- Gen1 or Gen2, or a mix of Shelly generations: Use ATH Bridge or set up your own Homebridge server.
- Already using Home Assistant: You can share your Shelly devices with Apple Home through HomeKit Bridge.
- Want a bridge-free option for a supported older device: Advanced users can use custom HomeKit firmware. This is only available for selected models.
For homes with older Shelly devices or a mix of generations, ATH Bridge provides an easier option than building and maintaining your own Homebridge server.
Benefits of ATH Bridge
- Plug-and-play installation
- No Raspberry Pi required
- No Linux knowledge needed
- No Docker setup
- No firmware flashing
- Supports thousands of smart home devices
- Siri support
- Local HomeKit control
Instead of spending hours configuring a DIY server, ATH Bridge arrives ready to connect with Apple Home and your Shelly devices.
How Do You Add Shelly to Apple Home with ATH Bridge?
This is the recommended method for most users. ATH Bridge is a practical option for Gen1 and Gen2 Shelly devices, or for homes that use a mix of Shelly generations.
What You'll Need
- Shelly device connected to 2.4 GHz Wi-Fi
- ATH Bridge
- iPhone or iPad
- Apple home hub (HomePod, HomePod mini, or Apple TV) for remote access and automations
- Connect ATH Bridge to your home network and complete the initial setup.
- Make sure ATH Bridge and your Shelly devices are connected to the same local network.
- Open the Homebridge dashboard and choose the Shelly plugin that matches your device generation.
- For Gen1 devices, use homebridge-shelly.
- For Gen2 Plus and Pro devices, use homebridge-shelly-ng or homebridge-shelly-ds9.
- For Gen3 and Gen4 devices, use homebridge-shelly-ds9.
- If you use Shelly devices from different generations, you may need more than one plugin.
- Open the plugin settings in the Homebridge dashboard.
- Follow the plugin instructions to connect your Shelly devices.
- Save the settings and restart Homebridge if required.
- Make sure your Shelly devices and ATH Bridge are on the same network and subnet.
- Check that your Shelly devices appear correctly after the plugin setup is complete.
- If a device is missing, add its IP address manually in the plugin settings.
- Open the Apple Home app and check that your Shelly devices appear as accessories.
- Assign the devices to the correct rooms.
- Use Siri to control your Shelly devices.
- Create scenes and automations in Apple Home.
- Control your devices remotely when you have an Apple home hub set up.
How Do You Add Shelly to Apple Home with Matter?
Use this method if you have a Gen4 Shelly device or a Gen3 model that supports Matter.
Requirements
- Gen4 Shelly device or a Matter-supported Gen3 model
- Shelly device connected to 2.4 GHz Wi-Fi
- iPhone or iPad connected to the same Wi-Fi network
- Apple home hub (HomePod, HomePod mini, or Apple TV) recommended for remote access and automations
- Connect ATH Bridge to your home network and complete the initial setup.
- Make sure ATH Bridge and your Shelly devices are connected to the same local network.
- Open the Homebridge dashboard and choose the Shelly plugin that matches your device generation.
- For Gen1 devices, use homebridge-shelly.
- For Gen2 Plus and Pro devices, use homebridge-shelly-ng or homebridge-shelly-ds9.
- For Gen3 and Gen4 devices, use homebridge-shelly-ds9.
- If you use Shelly devices from different generations, you may need more than one plugin.
- Open the plugin settings in the Homebridge dashboard.
- Follow the plugin instructions to connect your Shelly devices.
- Save the settings and restart Homebridge if required.
- Make sure your Shelly devices and ATH Bridge are on the same network and subnet.
- Check that your Shelly devices appear correctly after the plugin setup is complete.
- If a device is missing, add its IP address manually in the plugin settings.
- Open the Apple Home app and check that your Shelly devices appear as accessories.
- Assign the devices to the correct rooms.
- Use Siri to control your Shelly devices.
- Create scenes and automations in Apple Home.
- Control your devices remotely when you have an Apple home hub set up.
Can You Use Your Own Homebridge Server Instead?
Advanced users can set up their own Homebridge server instead of using ATH Bridge. This gives you similar integration options, but you will need to set up and maintain the server yourself.
What You'll Need
- Raspberry Pi or another always-on computer
- Homebridge
- A Shelly plugin that supports your device generation
- Apple home hub (HomePod, HomePod mini, or Apple TV) for remote access and automations
Basic Process
- Install Homebridge on a Raspberry Pi or another computer that can stay powered on.
- Complete the initial Homebridge setup and open the dashboard.
- Choose a Shelly plugin that supports your device generation.
- Install the plugin from the Homebridge dashboard.
- Follow the plugin instructions to configure your Shelly devices.
- Make sure your Homebridge server and Shelly devices are on the same local network.
- Open the Apple Home app and add Homebridge using its HomeKit QR code.
- Check that your Shelly devices appear correctly in Apple Home.
- Assign your Shelly devices to rooms.
- Use Siri, scenes, and Apple Home automations to control them.
This method gives you more control over your Homebridge setup, but it requires more technical knowledge and ongoing maintenance.
Can You Flash Shelly with HomeKit Firmware?
Some Shelly devices can run third-party HomeKit firmware, which replaces the original Shelly firmware and lets the device connect directly to Apple Home without a bridge.
This option is available for selected Gen1 devices, Gen2 Plus devices, and some Gen3 models. Shelly Pro devices are not supported by this method.
Advantages
- Direct HomeKit integration
- No separate bridge required
- Local control
- You can return to the original Shelly firmware later if needed
Disadvantages
- Requires a more advanced flashing process
- Shelly Cloud and MQTT are not available while using the custom firmware
- Webhooks are not supported
- Not available for every Shelly model or Shelly Pro devices
For most users, ATH Bridge is a simpler option because it avoids manually replacing the device firmware.
Can You Add Shelly to Apple Home with Home Assistant?
If you already use Home Assistant, you can also bring your Shelly devices into Apple Home without setting up a separate Homebridge server.
- Open Home Assistant and add the Shelly integration.
- Make sure your Shelly devices appear correctly in Home Assistant.
- Add the HomeKit Bridge integration in Home Assistant.
- Choose the Shelly devices or entities you want to share with Apple Home.
- Open the Apple Home app.
- Scan the HomeKit QR code provided by Home Assistant.
- Complete the pairing process and assign your Shelly devices to rooms.
This method works well if Home Assistant is already part of your smart home, but it requires a Home Assistant server that you set up and maintain yourself.
ATH Bridge vs Matter vs Homebridge: Which Is Best for Shelly?
Each method can bring Shelly devices into Apple Home, but the right option depends on your device generation and how much setup you want to manage yourself.
| Feature | ATH Bridge | Matter | DIY Homebridge |
|---|---|---|---|
| Easy setup | Yes | Yes | No |
| Works with Gen1 and Gen2 | Yes | No | Yes |
| Works with Gen3 and Gen4 | Depends on plugin support | Gen4 and supported Gen3 models | Depends on plugin support |
| Extra hardware needed | ATH Bridge | No | Yes |
| Technical knowledge needed | Low | Low | Higher |
| Ongoing server maintenance | Low | No | Yes |
What Can You Do with Shelly in Apple Home?
Once your Shelly devices are connected to Apple Home, you can control them alongside your other Apple Home accessories and include them in everyday smart home routines.
Siri Voice Control
Use Siri to control supported Shelly lights, switches, plugs, and relays with voice commands.
Apple Home Automations
Create automations based on time, location, sensors, occupancy, and other accessories in your Apple Home setup.
Scene Support
Add Shelly devices to scenes such as Good Morning, Movie Night, Away Mode, or Bedtime and control several accessories together.
Remote Access
Control your devices while you're away from home when you have a HomePod, HomePod mini, or Apple TV set up as your home hub.
How Do You Fix Common Shelly Apple Home Problems?
Matter Option Is Missing
If you have a Gen3 device and cannot find the Matter option:
- Update the device to firmware version 1.6 or later.
- Check that your exact Gen3 model is on Shelly's Matter-compatible device list.
- Restart the device after updating the firmware and check the Matter settings again.
Can't Find the Matter Setup Code
Check the device label and the Matter settings in your Shelly device interface for the QR code or 11-digit setup code.
If you still cannot find the setup code, contact Shelly at:
integration@shelly.com
Shelly Won't Pair with Apple Home
- Make sure the Shelly device is connected to a 2.4 GHz Wi-Fi network.
- Make sure your iPhone or iPad, Shelly device, and Apple home hub are connected to the same home network.
- Restart the Shelly device and your Apple home hub or bridge.
- Try adding the accessory to Apple Home again.
Homebridge Can't Find Your Shelly Device
- Make sure Homebridge and the Shelly device are on the same network and subnet.
- Check that mDNS traffic on UDP port 5353 is not blocked by your network.
- If automatic discovery does not work, add the Shelly device's IP address manually in the plugin settings.
- For Gen1 devices, check the CoIoT settings and make sure the peer points to your Homebridge server IP on port 5683.
Shelly Appears Offline in Apple Home
- Check that the Shelly device is online in its original interface first.
- Restart the Shelly device and the bridge or home hub you are using.
- Make sure all devices are still connected to the same home network.
- If you use Homebridge, check that the Shelly plugin is running correctly.
Should You Use Matter or ATH Bridge for Shelly?
The best way to add Shelly to Apple Home depends on the generation you own. If you have a Gen4 device or a Matter-supported Gen3 model, Matter gives you a direct connection without needing a separate bridge.
For Gen1 and Gen2 devices, or homes with a mix of Shelly generations, ATH Bridge gives you another way to connect Shelly devices through Homebridge without setting up and maintaining your own Raspberry Pi or server.
Once connected, you can control supported Shelly devices in Apple Home, use Siri, and include them in scenes and automations.
Frequently Asked Questions
Ishara Fernando
Smart Home Researcher | Zigbee & Smart Home Technology Expert | Sharing Real-World Experiences & Research | Blogger & Freelance Writer | Turning Complex Smart Home Tech Into Simple, Practical Guides | Helping You Build Smarter, Connected Homes