Getting started

What is Shelly?

Shelly makes small smart modules and finished products that make your existing electrical installation smart – controlled via app, web or fully locally.

Shelly is a smart-home brand from Shelly Group (formerly Allterco Robotics). Most of the range is small modules you build into an installation you already have – behind a switch, inside a junction box or on a DIN rail – so that lighting, motors, heating and outlets become controllable. Alongside the modules there are finished products: smart plugs, light sources and battery-powered sensors.

The core idea: you keep your existing wiring and make it smart, instead of replacing it.

Three ways to control

The same device can be used in several ways – you decide how much to lean on the cloud:

• The Shelly Smart Control app – the easiest way in. Add devices, control them from home or remotely, build scenes and read consumption.
• The web – the same account at control.shelly.cloud, in an ordinary browser.
• Local and integrations – every device has a built-in web interface and can run entirely without Shelly's cloud, or connect to Home Assistant, MQTT, Matter and KNX.

Generations and series

Shelly has been through several generations, and the device names tell you a lot about what they can do. Most connect over Wi‑Fi (2.4 GHz), but some series use other radio technologies – BLU (Bluetooth) and Wave (Z‑Wave). Which generation and series you have decides what works, so it is worth sorting out early: see Which generation do you have? and The BLU series.

How to get started

1. Choose a device based on what you want to control – browse the device database.
2. Install it. Many modules sit on mains voltage and require the power to be cut – and sometimes an electrician. Read Installation and safety first.
3. Add the device, usually in the app.
4. Control and automate – rooms, groups and scenes, or fully locally via the web interface.

Do you need the app?

Not necessarily. The app is the easiest and most complete route, but if you want to run everything locally you can – devices are then managed through their own web interface or a home-automation system. This wiki covers both paths, not just the app.