SONOFF

SONOFF Smart Switches Troubleshooting

Find solutions for common SONOFF smart switches problems. Step-by-step guides to get your devices working again.

Visit SONOFF Official Site

Browse 20 troubleshooting guides for SONOFF smart switches. Each guide targets a specific problem — from initial setup and connectivity issues to performance drops and error codes — with step-by-step instructions, difficulty ratings, and estimated repair times. Select a guide below to start fixing your SONOFF device.

SONOFF makes practical, affordable automation hardware that lowers the barrier to smart home expansion.

Troubleshooting Guides (20)

How to Fix Sonoff Device Offline in eWeLink

Device: Sonoff eWeLink Offline (Sonoff WiFi switches, relays, plugs in eWeLink app)

A Sonoff device appears offline in eWeLink and cannot be controlled remotely. This often follows router changes, weak 2.4GHz conditions, overloaded APs, MAC filtering, or pairing done from the wrong network context.

easy 10-15 minutes 183 views

How to Fix Sonoff Zigbee Device Not Joining Bridge After Reset

Device: Sonoff Zigbee Join Failures (Sonoff bridge pairing after reset)

You factory reset a SONOFF Zigbee device (SNZB-01, SNZB-02, SNZB-03, SNZB-04, or ZBMINI) and it will not rejoin the SONOFF Zigbee Bridge or Zigbee Bridge Pro. The bridge may not be in pairing mode, the device may still be bound to a previous coordinator, or the bridge may have reached its device limit (32 on the original ZBBridge, 128 on the ZBBridge-P).

medium 10-15 minutes 85 views

How to Fix Sonoff Device Online but Not Responding in App

Device: Sonoff Command Sync (Sonoff POW/relay/switch devices showing online state only)

The Sonoff device appears online in eWeLink but command attempts fail or do not change physical state. This mismatch typically indicates cloud-command timeout, stale app session, firmware command queue issues, or router path instability.

medium 10-20 minutes 82 views

How to Fix Sonoff Device Fails Firmware Update in eWeLink

Device: Sonoff Firmware Updates (Sonoff devices in eWeLink update flow)

Your SONOFF device shows a firmware update available in eWeLink, but the update fails partway through — the progress bar stalls, the app shows an error, or the device reboots without completing the update. This happens most often with the BASICR4, MINIR4, and TH Elite models when WiFi signal is weak or the app loses its connection during the download. A failed firmware update can leave the device unresponsive if it was interrupted during the flash write.

medium 15-20 minutes 77 views

How to Fix Sonoff Smart Switch Not Updating Firmware

Device: Sonoff Firmware Update Failures (Sonoff OTA update reliability)

Your SONOFF smart switch shows a firmware update available in eWeLink, but the update fails or never completes. The progress bar may stall, the app may show an error message, or the device may reboot without applying the new firmware. Firmware updates require a stable WiFi connection and continuous power throughout the 1-4 minute process.

medium 15-20 minutes 68 views

Why Does Sonoff Device Keep Going Offline at Night?

Device: Sonoff Nighttime Dropouts (Sonoff WiFi device stability)

Your SONOFF device goes offline in eWeLink every night around the same time and comes back online in the morning. The device works fine during the day but consistently drops off at night. Common causes include router WiFi power-saving schedules that shut off the radio overnight, DHCP leases expiring while the device is idle, the circuit being on a switch or timer someone turns off at night, or a firmware bug that stops sending keepalive packets after extended idle periods.

medium 15-20 minutes 67 views

How to Fix Sonoff MINIR4 Losing Pairing After Firmware Update

Device: Sonoff MINIR4 Pairing Loss (MINIR4 post-update pairing persistence)

Your SONOFF MINIR4 was working fine, but after installing a firmware update it lost its WiFi configuration and entered pairing mode (LED blinking rapidly). The firmware updated successfully, but the WiFi credentials stored in flash memory were cleared during the process. You need to re-pair the device in eWeLink and reconfigure settings like Power-On State, external switch type, and third-party integrations.

medium 15-20 minutes 60 views

How to Fix Sonoff Device Unreachable on Local LAN Control

Device: Sonoff Local Reachability (Sonoff local API/LAN mode control)

You enabled LAN control in eWeLink but your SONOFF device is still unreachable over the local network. The app falls back to cloud control or shows the device as unavailable. LAN mode uses mDNS discovery to find devices on your local network — it fails when devices are on different subnets, when your router blocks multicast traffic, or when AP isolation is enabled.

medium 15-20 minutes 60 views

How to Fix Sonoff Pairing Succeeds but Device Stays Offline

Device: Sonoff Onboarding Drift (Sonoff WiFi devices in eWeLink)

You paired a SONOFF device in eWeLink and the app says pairing was successful, but the device immediately shows as offline. The pairing process registers the device on SONOFF's cloud, but the device itself failed to connect to your WiFi router. Common causes: incorrect WiFi password, router using WPA3 or 5GHz only, MAC address filtering blocking the device, or the DHCP pool being full.

easy 10-15 minutes 56 views

How to Fix Sonoff Device Name Changes Not Syncing Across Apps

Device: Sonoff Metadata Sync (eWeLink naming consistency)

You renamed a SONOFF device in the eWeLink app, but the old name still appears in Alexa, Google Home, or Home Assistant. Or you renamed it in Alexa but eWeLink still shows the original name. Device names are stored separately in each platform — renaming in one does not automatically propagate to others. This affects voice commands because Alexa and Google respond to the name stored in their own system, not the eWeLink name.

easy 10-15 minutes 55 views

How to Fix Sonoff Switch Schedule Not Running at Set Time

Device: Sonoff Schedule Timing Errors (eWeLink schedule execution timing)

Your SONOFF switch schedule is set in eWeLink to turn on at a specific time, but it fires early, late, or not at all. The most common cause is a wrong time zone in the eWeLink app settings. Other causes include cloud-based schedules failing when the device is temporarily offline, one-time schedules that auto-disable after firing, or conflicting automations from other platforms overriding the schedule.

medium 10-15 minutes 53 views

How to Fix Sonoff Switch Commands Timing Out in App

Device: Sonoff Command Timeout (Sonoff command delivery reliability)

Your SONOFF switch shows 'Command timed out' or 'Device not responding' when you try to toggle it in eWeLink. The switch may or may not actually respond to the command — sometimes the relay clicks but the app does not receive confirmation. This can affect one switch or all switches simultaneously, depending on whether the cause is local (WiFi signal) or cloud-side (SONOFF server issues).

medium 10-15 minutes 50 views

How to Fix Sonoff Device Stuck Offline After Power Outage

Device: Sonoff Post-Outage Recovery (Sonoff reconnect behavior after mains return)

Your SONOFF device went offline during a power outage and did not come back online when power returned. The eWeLink app shows the device as offline (grey icon). The LED on the device may be blinking rapidly (indicating it entered pairing mode) or solid but the cloud connection was not re-established. This is common with older SONOFF models that do not retry WiFi connections aggressively after boot.

easy 10-15 minutes 49 views

How to Fix Sonoff Switch State Desync in eWeLink

Device: Sonoff State Sync (Sonoff switch app/state consistency)

The eWeLink app displays the wrong on/off state for your SONOFF switch. The app says the switch is ON when it is actually OFF, or vice versa. This state mismatch causes confusion and can trigger incorrect automations. Common causes include stale app cache, incorrect external switch type configuration on in-wall models, and conflicting automations from multiple platforms sending opposing commands.

medium 10-15 minutes 35 views

How to Fix Sonoff Device Shows Offline Only on One Phone

Device: Sonoff Client-Specific Offline (eWeLink app session/device visibility)

Your SONOFF device appears online and controllable on one phone but shows offline on another. Both phones have the eWeLink app installed. The issue is usually a stale app cache on the affected phone, different eWeLink accounts or server regions, an outdated app version, or the phone being on a restricted network that cannot reach SONOFF's cloud servers.

easy 10-15 minutes 33 views

How to Fix Sonoff Device Reconnect Storm After Router Update

Device: Sonoff Post-Update Reconnect Storm (Sonoff WiFi stability after router firmware changes)

After updating your router firmware or changing WiFi settings, all your SONOFF devices went offline at once and are struggling to reconnect. Some come back after minutes, others stay offline for 30+ minutes, and a few may never reconnect without manual intervention. When 10-30 WiFi devices all try to associate simultaneously, they overwhelm the router's connection queue and create a cascade of failed attempts.

medium 15-20 minutes 32 views

How to Fix Sonoff Device Command Delays in eWeLink App

Device: Sonoff Command Latency (eWeLink command response performance)

Your SONOFF switch takes 2-5 seconds to respond after tapping on/off in the eWeLink app. The relay clicks late or sometimes the app shows a timeout error. Commands sent through Alexa or Google Home also feel sluggish. This delay happens because eWeLink routes commands through SONOFF's cloud servers by default, adding network round-trip latency on top of any local WiFi issues at the device.

easy 10-15 minutes 31 views

How to Fix Sonoff Device Not Rejoining After Power Loss

Device: Sonoff Post-Outage Recovery (Sonoff reconnect behavior after outages)

After a power outage, your SONOFF device does not come back online in eWeLink. The LED may be blinking rapidly (pairing mode triggered by power flicker), or the device boots before your router is ready and gives up trying to connect. Older models like the BASICR2 are especially prone to this because they do not retry WiFi connections indefinitely after a failed attempt.

medium 15-20 minutes 31 views

How to Fix Sonoff Device Not Appearing in Shared Home

Device: Sonoff Shared Home Visibility (eWeLink shared household device access)

You shared your SONOFF device or Home in eWeLink with a family member, but they cannot see the device in their app. The invitation may be pending, the accounts may be on different server regions (Americas vs. Europe), or the device was added before the Home was created and is not assigned to the shared Home. Shared users with 'Guest' permissions can also see devices but not control them.

easy 10-15 minutes 28 views

How to Fix Sonoff Device Failing to Sync State After App Control

Device: Sonoff App-State Sync (Sonoff control acknowledgment reliability)

The eWeLink app shows your SONOFF device as ON, but the actual device and connected appliance are OFF — or the reverse. The state displayed in the app does not match the physical relay position. This happens when a state change event gets lost between the device and the cloud, when the app cache is stale, or when multiple control sources (eWeLink, Alexa, Home Assistant) send conflicting commands.

medium 10-15 minutes 24 views