Shelly
homebridge-shelly · v0.19.1
Adds Shelly Gen 1 relays, dimmers, lights, plugs, sensors and shutters to HomeKit.
What it says it supports
Brands
- Shelly
Devices it names
- Shelly 1
- Shelly 1PM
- Shelly 2.5
- Shelly Dimmer 2
- Shelly Plug S
- Shelly Bulb 2
- Shelly Duo
- Shelly RGBW2
- Shelly Door/Window 2
- Shelly Flood
- Shelly H&T
- Shelly Motion
- Shelly Button 1
- Shelly i3
- Shelly 3EM
Shows up in Apple Home as from its README
- Lights
- Outlets
- Switches
- Buttons and Remotes
- Windows and Coverings
- Doors and Windows
- Garage Door Openers
- Sensors
- Valves
Sensor readings in its code
What people report
Most Gen1 Shelly relays, dimmers and sensors work, with CoAP multicast network issues the usual problem. Gen2 (Pro) devices and newer models are unrecognized in the legacy plugin and Homebridge 2.0 support is pending.
- Works9
- Partly works5
- Requested3
- Won’t be supported2
| Device | Status | What they said | Source |
|---|---|---|---|
| Shelly 1 | Works | Plugin available, or Mongoose firmware for native HomeKitSaved copyI’m contemplating installing a Shelly 1 behind a switch, as OZ Smart Things supposedly got type approval for them in Straya. There’s a Homebridge plug-in to suit, or you can install the Mongoose FW for native HomeKit support. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2021-12 |
| Shelly 1 | Works | Wired as smart doorbell, running within 30 minutesSaved copyI just (within the last 2 days) installed a Shelly 1 in my house with the intention of making my dumb doorbell smart. I got the wiring done, added the Shelly to the Shelly app, and then downloaded the appropriate plugin for Homebridge. I was up and running within 30 minutes. ~~A similar project using HA got written up on their forum and I saw comments like “my doorbell takes 10 seconds to be seen by HA every time someone pushes the button.” With my setup, everything is almost instant.~~ If I choose the Hombebridge, I don’t need to flash the smart device, in that case can I manage the device … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-10 |
| Shelly Button 1 | Works | Short, long and double press supportedSaved copyType: SHBTN-1 CoAP description: "{\"blk\":[{\"I\":1, \"D\":\"sensors\"}],\"sen\":[{\"I\":77, \"D\":\"battery\", \"T\":\"B\", \"R\":\"0/100\", \"L\":1}{\"I\":118,\"T\":\"S\",\"D\":\"Input\",\"R\":\"0\",\"L\":1},{\"I\":119,\"T\":\"S\",\"D\":\"Input event\",\"R\":\"S/SS/SSS/L\",\"L\":1},{\"I\":120,\"T\":\"S\",\"D\":\"Input event counter\",\"R\":\"U16\",\"L\":1}]}" CoAP status: "{\"G\":[[0,77,100][0,118,0],[0,119,\"S\"],[0,120,1]]}" HTTP Settings:: … Excerpt saved from GitHub on 2026-10-22. | Issue #131 · 2020-06 |
| Shelly devices | Works | Plugin auto-detects devices, remote access without Shelly cloudSaved copyYes, you can access the Shelly via HomeKit/Homebridge remotely without using Shelly cloud. I like how Homebridge-Shelly plugin gives a webpage that you can see and navigate to all the web interfaces of the Shelly devices on your network. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2021-12 |
| Shelly Dimmer 2 | Works | Support added via merged PRSaved copyadded support for Shelly Dimmer 2 Excerpt saved from GitHub on 2026-10-22. | PR #135 · 2020-06 |
| Shelly Motion | Works | Support added via merged PRSaved copy> > homebridge no longer detects shelly motion on fw v1.1.0 > > > Have you entered something in Internet & Security, CoIoT, Remote address in Shelly Motion web UI? I don‘t think the Shelly can be detected by the plugin anymore as multicast has been disabled in 1.1.0 tried with and without homebridge IP. Makes no differance. You are right, same for me... so Shelly Motion 1.1.0 no longer work for this plugin. Excerpt saved from GitHub on 2026-10-22. | PR #268 · 2021-02 |
| Shelly relay | Works | Recommended for smart switches; Shelly pluginSaved copyhomebridge-ewelink-max - As I'm too lazy to flash sonoff devices that I have, this plugin exposes them to HomeKit with minimal configuration. homebridge-shelly - Same thing, for Shelly devices homebridge-broadlink-rm - Controlling RF and IR devices from HomeKit Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2019-08 |
| Shelly relays behind Clipsal 2000 switches | Works | Works really well, supports two-way switchesSaved copyI went with Shelly's behind the existing Clipsal 2000 light switches. Works really well and visitors can use them without having to fuss about with an app or anything like that. They can also be wired up to work with existing 2 way switches so that any of the switches or the Shelly can toggle on/off the power (and the current state of the light is always correct in HomeKit). Note that you'll technically need an electrician to install these legally in Australia, and unless you really know what you're doing, I'd recommend actually hiring one for this job. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2021-12 |
| Shelly RGBW2 controller | Works | Color control from HomeKit, local control possibleSaved copyCheck out the Shelly RGBW2 controller which has a Homebridge plugin. You can change the color from the HomeKit control on your phone. You can control it via automations, you can also control it locally with a light switch (optional) and it is even small enough to put into a light switch box permanently (and is UL certified), so it’s invisible. (Ie: you could have a light switch which turns on/off the light strip - but can also be controlled via HomeKit). I use it for a light strip and it works great. I use Shelly 1 and 2 for relays switches elsewhere. Pretty solid in general. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2020-12 |
| Shelly 1, 2.5 and Dimmer 2 (Hoobs) | Partly works | EHOSTUNREACH loading settings; fixes were dual WAN off or auth changeSaved copyDescribe the bug Plugin finds the Shellys, but states cant be set Log output 22/06/2021, 21:45:32HOOBSShellyERRORFailed to load device settings 22/06/2021, 21:45:32HOOBSShellyERRORError: connect EHOSTUNREACH 192.168.0.27:80 (device SHSW-1 25A2CB, at 192.168.0.27) 22/06/2021, 21:45:36HOOBSShellyERRORFailed to load device settings 22/06/2021, 21:45:36HOOBSShellyERRORError: connect EHOSTUNREACH 192.168.0.70:80 (device SHSW-25 40F5202A70DE, at 192.168.0.70) 22/06/2021, 21:45:36HOOBSShellyERRORFailed to load device settings 22/06/2021, 21:45:36HOOBSShellyERRORError: connect EHOSTUNREACH … Excerpt saved from GitHub on 2026-10-22. | Issue #319 · 2021-06 |
| Shelly 1PM | Partly works | Can turn on but not off for some users; cause was dead units or IGMPSaved copyDescribe the bug All my Shelly 1 PM devices have been behaving strangely for a few days now: I can activate them, but it's not possible to deactivate them. With the shelly app, everything works fine. Log output Nothing in the log: ^[[37m[27.2.2024, 12:55:22]^[[0m ^[[36m[HB Supervisor]^[[0m OS: Linux 6.1.74-v7+ arm ^[[37m[27.2.2024, 12:55:22]^[[0m ^[[36m[HB Supervisor]^[[0m Node.js v20.11.1 /opt/homebridge/bin/node ^[[37m[27.2.2024, 12:55:22]^[[0m ^[[36m[HB Supervisor]^[[0m Homebridge Path: /var/lib/homebridge/node_modules/homebridge/bin/homebridge ^[[37m[27.2.2024, 12:55:22]^[[0m ^[[36m[HB … Excerpt saved from GitHub on 2026-10-22. | Issue #467 · 2024-02 |
| Shelly 2 / 2.5 roller shutter | Partly works | HomeKit position can desync from device; workaround with delayed pollingSaved copyThis plugin actually uses the REST API to get the current roller shutter position. I think the Shellies will start reporting their positions over CoAP in the next firmware update, but so far what is transmitted is just the states of the relays. I’ve used this to determine if the roller shutter is stopped (no relay is active) or if it is moving (one of the relays is active). Whenever the states of the relays change the API is queried to get the current position, which means that the API is queried once when the shutter starts moving and once when it stops moving. So if the position in the Home … Excerpt saved from GitHub on 2026-10-22. | Issue #12 · 2019-02 |
| Shelly 2.5 and Dimmer 2 | Partly works | Detected after firmware updates but only dimmer controllable in HomeKitSaved copyUpdate. So it turned out both the new 2.5 and dimmer2 required firmware updates, the Shelly app eventually discovered them and resolved that. Honebridge detects everything but I’m only able to control the dimmer now in hk. Shelly app controls everything properly. Very odd, I’ve disabled IGMP snooping which may have helped? I think I’ll continue to add devices and try to work it out as I go along but will not be until tomorrow so I’ll try any suggestions I might get here first. Some lights turn on in hk but not off again. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2022-07 |
| Shelly Dimmer | Partly works | Fails to switch off after firmware beta; others traced to power supplySaved copyHomeKit with home bridge being its hub docent switch off the shelly dimmer after it is updated to Shelly's Beta RC5. switching on and dimming works fine Excerpt saved from GitHub on 2026-10-22. | Issue #287 · 2021-03 |
| Shelly 0-10V dimmer | Requested | New device request, still openSaved copyWe have ordered a new device from Shelly 0-10, but we cannot yet read it within the Homey system. This can be uploaded in the Shelly app. However, this does not extend to the Homey environment. Is this known to you? Excerpt saved from GitHub on 2026-10-22. | Issue #452 · 2023-11 |
| Shelly 1AddOn | Requested | Thermostat support PR still openSaved copyAs many and myself would like to have a thermostat I created one based on the shelly actions therefore the MR of https://github.com/alexryd/node-shellies/pull/30 required. To install and test, (you may need to re-add your shelly): `sudo npm i -g @tritter/homebridge-shelly` Shelly 1AddOn configurations *Applies to Shelly 1, 1PM* `"sensors"` - 1-3, number of sensors connected to the addon. (default:1 , max: 3) `"type"` - when the relais should act like a thermostat set the type to `"thermostat"` `"humidity"` - false, shows humitidy (only applicable to one sensor) `"heating"` - true|false, … Excerpt saved from GitHub on 2026-10-22. | PR #336 · 2021-09 |
| Shelly Gen3 devices | Requested | Plugin lacks Gen3 support; author not taking issuesSaved copyGreeting, As far as I remember the following Homebridge plugin is the most popular for integrating Shelly devices into Apple Home, and I know it working flawlessly. That goes for Shelly Gen2 devices. https://www.npmjs.com/package/homebridge-shelly-ds9 I'm wondering how come the plugin still hasn't gotten support for Shelly Gen3 devices? HomeAssistant introduced it almost at the same time as the Gen3 product line was released. Is there maybe another Shelly plugin on Homebridge that works on Gen3 devices but provided it works flawlessly? Thanks. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2025-01 |
| Samsung TV (mis-detected as Shelly) | Won’t be supported | TVs speak CoAP and show as unsupported Shelly; maintainer to excludeSaved copyfor me it is a samsung tv Excerpt saved from GitHub on 2026-10-22. | Issue #139 · 2020-06 |
| Shelly Pro 4PM | Won’t be supported | Unknown device model; plugin fails to add itSaved copyhi, i install the plug in in my hoobs but I see the error in object. Can you help me? 23/08/2024, 20:53:25Shelly Ng BridgeShellyNGERRORFailed to add discovered device (id: shellypro4pm-08f9e0ea14d8): shutting down in 1897 ms 23/08/2024, 20:54:15Shelly Ng BridgeShellyNG[shellypro4pm-08f9e0ea14d8] Unknown device of model "SPSW-104PE16EU" discovered. 23/08/2024, 21:03:16Shelly Ng BridgeConfiguration change 23/08/2024, 21:03:16shellyngbridge stopping 23/08/2024, 21:03:21Shelly Ng Bridge starting 23/08/2024, 21:03:24Shelly Ng BridgeLoaded plugin 'homebridge-shelly-ng' 23/08/2024, 21:03:24Shelly Ng … Excerpt saved from GitHub on 2026-10-22. | Issue #481 · 2024-08 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Shelly local HTTP and CoIoT on the LAN
You’ll need
- Shelly device IP address
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | >=1.0.0 |
| Homebridge 2.0 | No |
| Node.js | >=8 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | Shelly |
| License | MIT |
Community signals
| Downloads a week | 140 |
|---|---|
| Downloads a month | 391 |
| GitHub stars | 303 |
| Open issues | 245 |
| Closed issues | 221 |
| Last code push | 2023-03-04 |
| Latest version | 0.19.1 (2021-08-09) |
| First published | 2018-12-16 |
| Releases | 47 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Shelly Motion needs CoIoT remote address set to the Homebridge host
- Roller mode needs calibration and firmware 1.4.9+
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- BatteryService
- ContactSensor
- Door
- GarageDoorOpener
- HumiditySensor
- LeakSensor
- LightSensor
- Lightbulb
- MotionSensor
- OccupancySensor
- Outlet
- ServiceLabel
- SmokeSensor
- StatelessProgrammableSwitch
- Switch
- TemperatureSensor
- Valve
- Window
- WindowCovering
Sources
- npm: https://www.npmjs.com/package/homebridge-shelly
- Source code: https://github.com/alexryd/homebridge-shelly
- Issues: https://github.com/alexryd/homebridge-shelly/issues
- Verified plugins list: https://github.com/homebridge/verified



