Shelly troubleshooting
Pick the problem you're seeing. Each guide lists the likely causes, how to tell which one you have, and the fix for each.
22 guides
- Wiring & switchingShelly 1L or 2L light flickers or won't work without neutralLED lights that flicker, won't switch reliably or don't work at all on a Shelly 1L or 2L Gen3. Most of it comes down to the Bypass, the globes and which output the light is on.Gen3
- Wiring & switchingShelly LED strip shows the wrong colours or won't workColours swapped, the white channel dead, colours off at low brightness or a wall switch that does nothing. On a Shelly RGBW controller it's usually the profile, the wiring or the strip.Gen2 · Pro
- Wiring & switchingLight flickers or glows when the Shelly is offLED globes that glow faintly when off, flicker when dimmed or won't start at a low level. Most of it comes down to the Dimmer Gen4's wiring, calibration and brightness settings.Gen4
- Setup & Wi-FiLocked out of a Shelly's web pageThe web page asks for a password nobody knows, keeps refusing the right one, or jumps to https with a browser warning. What each means and how to get back in.Gen4
- SensorsShelly Add-on temperature sensor shows no readingA DS18B20 probe on the Plus Add-on shows N/A, never appears, or reads the wrong number. Check the Add-on is switched on, the probe is added, and where the Shelly sits.Gen4
- Wiring & switchingShelly blind or curtain calibration failsCalibration won't finish, the position slider is missing, or the blind stops short or goes the wrong way. Check the time limits, the direction and the motor's own end limits.Gen3 · Gen4 · Pro
- Setup & Wi-FiShelly BLU device not found, or stopped reportingA BLU sensor or button won't show up when you add it, or it was working and went quiet. Check it's awake, that a Shelly near it is acting as its gateway, and how you added it.Gen4
- Offline & cloudShelly keeps restarting or overheatsIt reboots on its own, or switches off while a heavy load runs. Check whether it really restarted, then the scripts, schedules and firmware, then the load.Gen4
- Home Assistant & MatterShelly Matter pairing failsApple Home, Google Home or Home Assistant can't add your Shelly over Matter, or it adds and shows No Response. Usually it's the pairing window or IPv6.Gen4
- Setup & Wi-FiShelly not found during setupYou go to add a new Shelly and the app can't see it. Usually the setup window has closed, Bluetooth is off, or the device is already on your Wi-Fi.Gen4
- Power meteringShelly power reading shows zero or looks wrongThe watts read 0, go negative, or the energy total doesn't add up. Check the device meters at all, then the output, the settings and the counters.Gen4
- SensorsShelly Presence Gen4 misses people or detects an empty roomLights go off while you sit still, or it says someone's there when nobody is. Check the thresholds, the room's boundary and blind spots, and how the sensor is mounted.Gen4
- Wiring & switchingShelly relay clicks but the light or appliance doesn't turn onThe relay clicks and the app says On, but nothing gets power. Check what the app and web page show, then the timers, the other controls and the protections.Gen4
- SchedulesShelly schedule runs at the wrong time, or doesn't runA schedule fires an hour out, sunset runs at the wrong time, or nothing happens at all. Check the device's clock and time zone first, then its location and the schedule itself.Gen4
- ScriptsShelly script won't start or keeps stoppingYou click Run and the script stops straight away, or it works until the next restart. The Scripts page and the console tell you which cause you have.Gen2 · Gen3 · Gen4 · Pro
- Wiring & switchingShelly wall switch does nothingThe app turns the light on and off, but the wall switch doesn't. Most of the time it's a setting on the device, and you can check it from a browser.Gen4
- Setup & Wi-FiHow to factory reset a ShellyWipe a Shelly back to how it left the factory, from the app, its own web page or the button. Which one you use depends on whether you can still reach it.Gen4
- FirmwareShelly firmware update failsThe update won't start, won't finish, or the device can't be reached to update at all. Most of the time it's the connection to Shelly's update server.Gen4
- Home Assistant & MatterShelly not showing up in Home AssistantThe Shelly works in its own app, but Home Assistant never finds it, can't add it, or adds it with entities missing. Most of the time it's the network.Gen4
- Offline & cloudShelly shows offline in the appThe device still works from the wall switch, but the app says it's offline. Find out whether it's lost Wi-Fi, lost the Shelly cloud, or something else.Gen4
- Wiring & switchingShelly turns on by itself after a power cutThe power comes back and so does the light, even though you'd turned it off. It's usually the power-on setting, and it takes a minute to change.Gen4 · Gen3 · Gen2
- Setup & Wi-FiShelly won't connect to Wi-FiSetup stalls, the app can't find the device, or it joins and drops off. Most of the time it's the 2.4 GHz band, the setup window or a router setting.Gen4
