Shelly Beta with Plus/Pro Support


The Shelly Binding integrates the Allterco Shelly Devices. It supports Generation 1 (Shelly 1 etc.) as well as the complete Shelly Plus and Pro Series (Generation 2).


  • Auto Discovery of connected Shelly devices
  • Provide a lot of status data (relay status, power meter, sensor values)
  • Some internal device information like wifi strength or internal device temp
  • Event trigger, e.g. for pushed buttons
  • Control functions like relay output on/off
  • Shelly Manager for device configuration and firmware upgrades

See documentation in Resources section for setup.


19.11.2022 3.4 M3/M4 (PR# #13520)

  • Updated to Californium 2.7.3 coming with OH 3.4 M3 and newer
  • Support for new ShellyPlus Add-On
  • Support for Shelly1/1PM External Switch Add-On

1.10.2022: 3.4 PR4

  • includes Plus / Pro support for all new devices (while keeping compatibility for Gen1 devices)
  • merge is requested (PR #13439)

Status and future development.

Feedback is always welcome (do not hesitate to tell if it works !) Share your experiences, creative work or problems in the Community Thread. Also ideas and contributions are welcome.

A pull request is pending to merge Plus/Pro support to the official distro (3.4 will be released by end of the year).

Contribution welcome ! There is so much to do :

  • Testing with all devices and all setup types
  • Description of more use cases so others benefit from your work
  • Maybe some nice widgets for Main UI

Make sure to select the correct bundle matching your installed openHAB release
The are different builds for openHAB 3.2, 3.3, 3.4 M1/M2 (supported by the 3.4M2 build)
and openHAB starting with 3.4 M3 (supported by the 3.4M3 build).

You need to install the Californium Soap implementation before installing the binding

  1. open OH console and run “feature:install openhab-transport-coap”
  2. and then copy the binding jar to the adding folder

The binding supports auto-discovery, there is no need to create .thing files. Maybe you need to scan multiple times to find all devices on your network. Docker users: You need to make sure that the container receives Multicast traffic for generation 1 devices (no Plus/Pro), or configure the device to CoIOT Peer Mode (using device UI or build-in Shelly Manager).


org.openhab.binding.shelly-3.4.0M3-SNAPSHOT.jar (OH 3.4 M3/M4)
org.openhab.binding.shelly-3.4.0M3-SNAPSHOT.jar (OH 3.2, 3.3, 3.4 M1/M2)

Shelly API Reference

README | Advanced Use Cases | Shelly Manager
Bugs Reports /Feature Requests


Awesome! I don’t have pro/plus devices but I just got 4 Shelly 2.5s for my shutters and your binding will come in handy!
Thank you!

The version included with the official distro already includes full support for Shelly 2.5, this version here mainly has in addition support for Plus/Pro devices, but also bugfixes for Gen 1 devices.
Thanks for using the binding :slight_smile:

1 Like

Sorry, but I get errors trying to install the binding.
“Installation of add-on marketplace:139554 failed”.
I update/upgraded Openhab and Java to latest version. But the problem remains. After googling a lot, I could not find a solution.

What errors ? Shall we guess ?


same here … :frowning:

Did install Californium Soap and copied org.openhab.binding.shelly-3.4.0M3-SNAPSHOT.jar to the admins-folder …

But the binding did not appear UI->Things>“+” (no entry to scan for new shelly).

Did I miss something?


@hmerk Thanks for prompt reply.
I wrote the error message in the 2nd line. → “Installation of add-on marketplace:139554 failed”

Sorry but I’m not an advanced user. So give me a hint where I can get more useful information.

BR, Moikus

And also trying to execute from local memory via terminal is not working.

This is not supposed to work.

Did you follow the correct steps ?


open OH console and run “feature:install openhab-transport-coap”

Then download the correct binding .jar to your addons folder.
I guess automatic installation fails cause there are two versions listed.

Thanks for quick reply. I followed your steps.
Automatic installation failed again. What to do next?
And is it necessary to uninstall standard shelly binding? (I think so^^)
And where can I find the ‘correct steps’?

Of course, you first need to uninstall the old binding version.

1 Like
1 Like

Dear Mark, thanks also for prompt reply.
I added the following to /addons:

And tried to install via Openhab web frontend

I just saw, I need to upgrade to Milestone3.4.0.M4

No, you don‘t, there is a version shown working with openHAB 3.3 !

And please, don‘t try to install from marketplace after adding the .jar file to your addons folder. This is not necessary and will produce errors.

You can check if the correct binding is running by entering


on openHAB console.

Hello everyone, unfortunately I also get an error message when starting the binding.
I think you need to update the Californium packages. After much googling, I can’t find a way to do it.
Is there a guide on how to install the binding?

how shall I install the .jar from addons folder?

Just drop it there, openHAB will get it automatically. Please keep in mind, those bindings never show up as installed in the UI.

I do experience the same issue “Installation of add-on marketplace:139554 failed” unfortunately In not very experienced and I can’t solve the issue. I am also not able to download the binding

I hope to get some hints
Thank you in advanced