Skip to content
Homebridge TestFlight
Shelly

Shelly

homebridge-shelly · v0.19.1

VerifiedLocal

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

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
DeviceStatusWhat they saidSource
Shelly 1WorksPlugin available, or Mongoose firmware for native HomeKit
Saved copy
I’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 1WorksWired as smart doorbell, running within 30 minutes
Saved copy
I 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 1WorksShort, long and double press supported
Saved copy
Type: 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 devicesWorksPlugin auto-detects devices, remote access without Shelly cloud
Saved copy
Yes, 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 2WorksSupport added via merged PR
Saved copy
added support for Shelly Dimmer 2

Excerpt saved from GitHub on 2026-10-22.

PR #135 · 2020-06
Shelly MotionWorksSupport added via merged PR
Saved 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 relayWorksRecommended for smart switches; Shelly plugin
Saved copy
homebridge-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 switchesWorksWorks really well, supports two-way switches
Saved copy
I 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 controllerWorksColor control from HomeKit, local control possible
Saved copy
Check 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 worksEHOSTUNREACH loading settings; fixes were dual WAN off or auth change
Saved copy
Describe 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 1PMPartly worksCan turn on but not off for some users; cause was dead units or IGMP
Saved copy
Describe 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 shutterPartly worksHomeKit position can desync from device; workaround with delayed polling
Saved copy
This 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 2Partly worksDetected after firmware updates but only dimmer controllable in HomeKit
Saved copy
Update. 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 DimmerPartly worksFails to switch off after firmware beta; others traced to power supply
Saved copy
HomeKit 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 dimmerRequestedNew device request, still open
Saved copy
We 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 1AddOnRequestedThermostat support PR still open
Saved copy
As 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 devicesRequestedPlugin lacks Gen3 support; author not taking issues
Saved copy
Greeting, 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 supportedTVs speak CoAP and show as unsupported Shelly; maintainer to exclude
Saved copy
for me it is a samsung tv

Excerpt saved from GitHub on 2026-10-22.

Issue #139 · 2020-06
Shelly Pro 4PMWon’t be supportedUnknown device model; plugin fails to add it
Saved copy
hi, 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 HomebridgeYes
Homebridge versions>=1.0.0
Homebridge 2.0No
Node.js>=8
Settings in Homebridge UIYes
MatterNo
Platform nameShelly
LicenseMIT

Community signals

Downloads a week140
Downloads a month391
GitHub stars303
Open issues245
Closed issues221
Last code push2023-03-04
Latest version0.19.1 (2021-08-09)
First published2018-12-16
Releases47

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