Open-Awesome
CategoriesAlternativesStacksSelf-HostedExplore
Open-Awesome

© 2026 Open-Awesome. Curated for the developer elite.

TermsPrivacyAboutGitHubRSS
  1. Home
  2. Home Assistant
  3. Sonoff LAN

Sonoff LAN

MITPythonv3.12.2

A Home Assistant custom component to control Sonoff smart devices with original eWeLink firmware over LAN and/or cloud.

GitHubGitHub
3.3k stars463 forks0 contributors

What is Sonoff LAN?

SonoffLAN is a custom integration for Home Assistant that allows users to control Sonoff smart devices—like switches, sensors, and power monitors—directly from their home automation setup. It connects to devices using their original eWeLink firmware over local network (LAN) and/or cloud, solving the problem of vendor lock-in without requiring firmware modifications.

Target Audience

Home Assistant users who own Sonoff devices and want to integrate them into their local smart home ecosystem while retaining stock firmware features.

Value Proposition

Developers choose SonoffLAN because it provides reliable, dual-protocol access to Sonoff hardware without the complexity and risk of flashing custom firmware, offering seamless integration with Home Assistant's automation capabilities.

Overview

Control Sonoff Devices with eWeLink (original) firmware over LAN and/or Cloud from Home Assistant

Use Cases

Best For

  • Integrating Sonoff switches and sensors into Home Assistant without firmware replacement
  • Controlling smart devices locally to reduce cloud dependency and improve response times
  • Monitoring power consumption and energy usage with Sonoff Pow devices
  • Automating RF-based sensors and remotes via the Sonoff RF Bridge
  • Managing multi-account or multi-home eWeLink setups within a single Home Assistant instance
  • Creating custom device mappings (e.g., treating a switch as a light or fan) in home automation

Not Ideal For

  • Environments with unreliable multicast DNS (mDNS/zeroconf) where local device discovery frequently fails
  • Projects requiring real-time, cloud-free updates for power, current, and voltage sensors beyond 2026
  • Users who need 100% stable local control without any cloud fallback for critical automations

Pros & Cons

Pros

Dual Protocol Reliability

Simultaneously uses LAN and cloud connections, with auto mode switching for fallback, ensuring device availability even when local networks are unstable.

No Firmware Flashing

Works with stock eWeLink firmware, eliminating the risk and effort of installing custom firmware like Tasmota while retaining manufacturer features.

Broad Device Support

Controls a wide range of Sonoff devices, including switches, power monitors, temperature sensors, RF bridges, and cameras, as documented in DEVICES.md.

Real-Time State Updates

Provides instant device status changes through local multicast or cloud WebSocket connections, enabling responsive home automation.

Cons

Local Protocol Instability

The README admits that local connections can be unreliable, with devices sometimes disappearing from the network or failing to respond, requiring cloud fallback.

Cloud Sensor Limitations

Starting in 2026, power sensors won't update via cloud, and some devices like THR316D/THR320D require cloud for thermostat control, limiting offline functionality.

Complex Network Setup

Requires proper multicast (mDNS/zeroconf) configuration, which can be problematic in Docker, VMs, or with certain routers, as highlighted in common issues.

Frequently Asked Questions

Quick Stats

Stars3,278
Forks463
Contributors0
Open Issues175
Last commit7 days ago
CreatedSince 2019

Tags

#iot#local-control#home-automation#smart-home#hacs#home-assistant#custom-component#sonoff

Built With

H
Home Assistant
P
Python

Included in

Home Assistant7.5k
Auto-fetched 17 hours ago

Related Projects

SmartIRSmartIR

Home Assistant integration to manage climate systems, TVs, fans and lights using IR/RF controllers. Compatible with Broadlink, Xiaomi, MQTT, LOOKin and ESPHome

Stars2,787
Forks1,233
Last commit1 year ago
WebRTC CameraWebRTC Camera

Home Assistant custom component for real-time viewing of almost any camera stream using WebRTC and other technologies.

Stars2,154
Forks234
Last commit8 months ago
Xiaomi Cloud Map ExtractorXiaomi Cloud Map Extractor

This custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.

Stars1,411
Forks160
Last commit5 months ago
Circadian LightingCircadian Lighting

Circadian Lighting custom component for Home Assistant

Stars894
Forks101
Last commit10 months ago
Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a projectStar on GitHub