Skip to content
Shelly smart home platform for Home Assistant
Branch: master
Clone or download
Latest commit a1edf65 Sep 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
custom_components/shelly 0.1.0 Sep 18, 2019
images 0.0.15 Jul 21, 2019
screenshots Bug fixes, Apr 5, 2019
util 0.0.15 Jul 21, 2019
.gitignore 0.0.8 Apr 14, 2019
LICENSE 0.0.8 Apr 14, 2019 Update Sep 18, 2019
custom_updater.json Update custom_updater.json Sep 18, 2019 0.0.16 Aug 21, 2019

Shelly smart home platform for HASS and HASSIO

founder-wip buy me a coffee

stability-wip version-wip hacs_badge

This platform adds components for Shelly smart home devices to Home Assistant. There is no configuration needed, it will find all devices on your LAN and add them to Home Assistant. All communication with Shelly devices is local. You can use this plugin and continue to use Shelly Cloud, MQTT and Shelly app in your mobile if you want. A proxy can also be used to include Shellies on different LAN's.



  • Automatically discover all Shelly devices
  • Monitor status (state, temperature, humidity, power, rssi, ip, fw, battery, uptime etc.)
  • Control (turn on/off, dim, color, effects, up/down etc.)
  • Sensors for most of the attributes
  • Switch sensors to show status of switch button (0.0.16)
  • Detection of click and multiple quick clicks by events
  • Works with Shelly default settings, no extra configuration
  • Runs locally, you don't have to add the device to Shelly Cloud
  • Coexists with Shelly Cloud so you can continue to use Shelly Cloud and Shelly apps
  • Using CoAP and REST for communication (not MQTT)
  • Working with both static or dynamic ip addresses on your devices
  • Using events so very fast response (no polling)
  • Support restrict login with username and password (0.0.3-)
  • Version sensor to show version of component and pyShelly (0.0.4)
  • Device configuration (name, show switch as light) (0.0.4)
  • Discovery can be turned off (0.0.4)
  • Switch for firmware update trigger (use with monster-card to show a list of devices to need to be update, see examples below)
  • Support proxy to allow Shelly devices in other LANs (0.0.15).

Devices supported

  • Shelly 1
  • Shelly 1 PM (no power meter, firmware bug)
  • Shelly 2 (relay or roller mode)
  • Shelly 2.5 (relay or roller mode)
  • Shelly 4
  • Shelly Bulb
  • Shelly EM
  • Shelly H&T
  • Shelly Plug
  • Shelly Plug S
  • Shelly RGBWW
  • Shelly RGBW2
  • Shelly 2LED (not verified)
  • Shelly Flood
  • Shelly Dimmer
  • Shelly EM (comming soon)


Install with HACS (recomended)

Do you you have HACS installed? Just search for Shelly and install it direct from HACS. HACS will keep track of updates and you can easly upgrade Shelly to latest version.

Install with Custom Updater (deprecated)

We recomend you use HACS as Customer Updater is deprecated.

Do you you have Custom updater installed? Then you can use the service custom_updater.install with the parameter {"element":"shelly"} to install Shelly.

Custom updater also let you to upgrade to latest version. We recomend you to use this.

Install manually

  1. Install this platform by creating a custom_components folder in the same folder as your configuration.yaml, if it doesn't already exist.
  2. Create another folder shelly in the custom_components folder. Copy all 5 Python (.py) files from custom_components into the shelly folder. Use raw version if you copy and paste the files from the browser.


When you have installed shelly and make sure it exists under custom_components folder it is time to configure it in Home Assistant.

It is very easy, just add shelly: to your configuration.yaml


Default with discovery and power sensors


Without discovery - manually specify devices

  discovery: false
  version: true #add version sensor
    - all
  devices:      #devices to be added
    - id: "420FC7"
    - id: "13498B-1"   #Shelly 2, Id + Channel number
    - id: "7BD5F3"
      name: My cool plug   #set friendly name
      sensors: #overide global (all)
         - power
         - device_temp

With discovery - adjust some devices

  discovery: true  #add all devices (default)
  sensors: #sensors to show, can be override on each device
    - rssi
    - uptime
  devices:  #configure devices
    - id: "420FC7"
      light_switch: true  #add this switch as a light
      sensors: [ switch ] #Override the global sensor
    - id: "7BD5F3"
      name: My cool plug #set friendly name

Sensor, global and per device

  discovery: true  #add all devices (default)
    - all #show all sensors
  devices:  #configure devices
    - id: "420FC7"
      light_switch: true  #add this switch as a light
    - id: "7BD5F3"
      name: My cool plug #set friendly name


  - alias: "Shelly turn off and then on quickly, any switch"
      platform: event
      event_type: shelly_switch_click
        click_cnt: 2
        state: True
  - alias: "Shelly double click (momentary) on a specific switch"
      platform: event
      event_type: shelly_switch_click
        entity_id: sensor.shelly_shsw_1_XXXXXX_switch
        click_cnt: 4        


Parameter Description Default Version
username User name to use for restrict login 0.0.3-
password Password to use for restrict login 0.0.3-
discovery Enable or disable discovery True 0.0.4-
version Add a version sensor to with version of component and pyShelly False 0.0.4-
devices Config for each device, se next table for more info 0.0.4-
show_id_in_name Add Shelly Device id to the end of the name False 0.0.5-
id_prefix Change the prefix of the entity id and unique id of the device shelly 0.0.5-
igmp_fix Enable sending out IP_ADD_MEMBERSHIP every minute False 0.0.5-
additional_information Retrieve additional information (rssi, ssid, uptime, ..) True 0.0.6-
scan_interval Update frequency for additional information 60 0.0.6-
wifi_sensor Add extra sensor for wifi signal of each device. Requires additional_information to be True. False 0.0.6 (deprecated)
uptime_sensor Add extra sensor for device uptime of each devivce. Requires additional_information to be True False 0.0.6 (deprecated)
power_decimals Round power sensor values to the given number of decimals 0.0.14-
sensors A list with sensors to show for each device. See list below. power 0.0.15-
upgrade_switch Add firmware switches when upgrade needed. True 0.0.15-
unavailable_after_sec Number of seconds before the device will be unavialable 60 0.0.16-

Device configuration

Parameter Description Example Version
id Device id, same as in mobile app 421FC7
name Specify if you want to set a name of the device My Cool Shelly
entity_id Override the auto generated part of entity_id, like shsw_1_500500 bedlamp 0.0.16-
light_switch Show this switch as a light True
sensors A list with sensors to show for each device. This will override the global sensors. See list below. 0.0.15-
upgrade_switch Add firmware switches when upgrade needed. Override global configuration. False 0.0.15-
unavailable_after_sec Overide number of seconds before the device will be unavialable. 120 0.0.16-


Sensor Description Values / Unit
all Show all available sensors
power Show power consumtion sensors W
rssi Show WiFi quality sensors dB
uptime Show uptime sensors s
over_power Show over power sensors True, False
device_temp Show device inner temperature sensors °C
over_temp Show over temperature sensors True, False
cloud Show cloud status disabled, disconnected, connected
mqtt Show mqtt connection state True, False
battery Show battery percentage (H&T) %
switch Show state of the actual switch button True, False

All of the sensors (not power) require additional_information to be True to work.

If you disable discovery only Shellies under devices will be added.

You can only specify one username and password for restrict login. If you enter username and password, access to devices without restrict login will continue to work. Different logins to different devices will be added later.


[Events added in release 0.0.16]


When the switch sensor is enabled an event will be sent for multiple clicks on the switch button. This can be used to trig automations for double clicks etc.

    "event_type": "shelly_switch_click",
    "data": {
        "entity_id": "sensor.shelly_shsw_1_xxxxxx_switch",
        "click_cnt": 4,
        "state": true
Parameter Description
click_cnt Number of clicks, 2 = turn back and forth quickly, 4 = double click on momentary switch.
state Current state of the switch, can be uset to distinct on-off-on from off-on-off for example.

Restart Home Assistant

Now you should restart Home Assistant to load shelly. Some times you need to restart twice to get the required library pyShelly installed. You can see this error in the log file.

Shelly will discover all devices on your LAN and show them as light, switch, sensor and cover in Home Assistant.

Proxy for VLAN or different network

If you running Shellies on different VLAN or network there is a that can be used to forward CoAP messages to ShellyForHASS plugin.

Update the script with the ip-address of your HASS installation and run it on a computer/router etc that are connected to same nettwork as your Shellies. Firewall and routing must be enabled, TCP 80 HASS -> Shelly and UDP 5683 Shelly -> HASS.

Monster card

You can use the component with monstercard to present data in a nice way.

All shelly devices

  show_header_toggle: false
  title: Shelly
  type: entities
    - entity_id: '*rssi*'
    - entity_id: '*uptime*'
    - entity_id: '*firmware*'
    - entity_id: '*shelly*'
type: 'custom:monster-card'

Need firmware update (click on the switch to update)

  show_header_toggle: false
  title: Shelly need update
  type: entities
    - entity_id: '*firmware_update*'
type: 'custom:monster-card'

WiFi signal of all devices (rssi)

  show_header_toggle: false
  title: Shelly
  type: entities
    - entity_id: '*rssi*'
type: 'custom:monster-card'


Please give us feedback on or Facebook groups: Shelly grupp (Swedish) or Shelly support group (English)


This plugin is created by the, the Swedish distributor of Shelly. In Sweden you can buy Shellies from or any of the retailers like, Kjell&Company etc.

buy me a coffee

Thanks to

  • @tefinger that have test and add functinallity to improve this component.
  • Allterco that have developed all nice Shellies and also response quickly on requests and bugfixes.

Screen shots

List RGB Effects White

You can’t perform that action at this time.