Shelly Wiki

Guides

Firmware and updates

What firmware is, how to update your Shelly, and why putting it off is not a good idea.

Firmware is the program running inside the device itself — not the app on your phone. The app talks to the device, but it's the firmware that actually drives the relay, reads the measurements, and decides which features are available right now.

That's why an older device can lack a feature that an identical, newer device has: it's not about the hardware, it's about which firmware happens to be on it.

How to update

There are three routes in, depending on how many devices you're dealing with at once.

One device, via the app. Go to the device → Settings → Firmware. If a newer version exists it's shown there, and you update with one tap.

All devices at once, via the app. Under My Home → All Devices there's an icon in the top-right corner that opens bulk updating — useful if you have many devices and don't want to click through them one by one.

Via the device's own web interface. If the device isn't in the app, or you're sitting directly on its local IP address, go to Settings → Firmware. There you'll see the device's ID, current firmware version, build ID and web build ID — and can press "Check for updates".

The local page also has a mode for uploading your own firmware manually. Doing so voids the warranty, according to Shelly's own documentation.

Stable channel and beta

Most updates go through the regular, stable channel. Some features, though, show up in a beta version before they become stable — Shelly's changelog lists individual features as "beta" in a release before they become standard.

Matter support for some Gen3 devices (1, 1PM, Mini 1, Mini 1PM, 2PM, 1L, 2L) is an example of that pattern: it was introduced in firmware 1.6.0, which was first rolled out in phases before becoming the default. By now firmware has moved well past 1.6.0, so if your device needs Matter, in practice it's enough to be on the latest stable version — see Which generation do you have? for which devices this applies to.

Exactly how you opt into a beta channel yourself, and whether you can go back to the stable version afterwards without a manual reflash, is something we haven't been able to fully verify in official documentation. Assume a beta update is harder to back out of than a stable one, and only update to beta if you actively want to test a specific feature.

Why update

It's tempting to ignore an update that "only" affects a light switch. But firmware is where security holes get patched, and where new features (like Matter support) actually land. A device that never gets updated risks both: known vulnerabilities that never get fixed, and missing features the rest of the documentation assumes you have.

Shelly also rolls out some versions in phases per model — so an update being available for one device doesn't automatically mean it's already available for another, seemingly identical, device.

Don't interrupt an update

Keep the device connected to power and network for the whole update. If power or network drops mid-write to the device's memory, you risk a device that doesn't restart correctly. If that's already happened, see Troubleshooting.

Checking which version you have

Easiest in the app: device → Settings → Firmware, the same place you update from. The same information is on the device's local web page under Settings → Firmware, along with build ID and web build ID — useful if you ever need to give support the exact version.

Not sure which generation the device even is? Start there instead: Which generation do you have?

Report an error on this page

Briefly describe what looks wrong — we read every report.