Hi everyone,
The official Shelly integration is local-only — it talks to devices on your LAN. But some Shellys aren't on your LAN: a device at a parent's or holiday home, a shared device someone gave you access to, or a Shelly BLU sensor bridged through a gateway you don't own. For those, I built Shelly Cloud DIY.
It uses the Shelly Cloud Control API with your own auth_key (the self-service key from the Shelly app — no partner/integrator API, no VPN, and no need to expose Home Assistant to the internet). It runs alongside the official integration and the Shelly app; it doesn't take over or lock anything out.
What it does
- Reads state for every device your Shelly account sees — owned, shared, remote, and BLE-bridged (BLU family via a BLU Gateway).
- Opt-in entities — you choose which devices materialise, so you don't get duplicates next to the local integration. Switches, lights, covers, sensors, binary sensors, buttons.
- Energy history import into long-term statistics.
- Fleet-Map (beta) — a read-only overlay that matches each cloud device to its local twin by MAC and flags anything whose control would secretly depend on the cloud.
- Replace device (beta) — transplant a dead Shelly's HA identity (entity IDs, history, automations) onto a new unit of the same model.
- Account cleanup (new, beta) — find, and optionally remove, HA devices whose hardware is no longer in your Shelly account.
- English + German UI.
Install
It's in the HACS default store — search for Shelly Cloud DIY, install, restart, then add the integration and paste your auth_key (Shelly app → user settings → authorization cloud key).
Honest limits
It's cloud polling (Shelly's ~1 req/s per-account budget), so it isn't sub-second like local control — it's built for reach, not raw speed. Where a device is on your LAN, keep the official local integration for control; this is the overlay for everything the local one can't see. OAuth + WebSocket realtime is the next milestone.
I'm the author and maintain it solo — feedback, issues, and device reports are very welcome.