November 23, 2026 · 9 min read
Sonoff + Home Assistant: The Complete Integration Guide
Every way to connect Sonoff devices to Home Assistant — Zigbee, WiFi local mode, and Matter — plus which Sonoff product to buy for each approach.
Sonoff makes some of the most affordable smart home hardware you can buy, and almost all of it works with Home Assistant — but "works with" can mean three very different things depending on the device. This guide covers all three integration paths, how to pick between them, and which Sonoff products fit each one.
The three ways Sonoff talks to Home Assistant
1. Zigbee (recommended for most people)
Sonoff's Zigbee lineup — the ZBDongle coordinators, SNZB sensors, and ZBMini switches — pairs with a Zigbee coordinator plugged into the machine running Home Assistant. Once paired, everything runs 100% locally: no cloud account, no internet dependency, and typically faster response times than WiFi.
You'll choose between two integration stacks:
- ZHA (Zigbee Home Automation) — built into Home Assistant, no extra software, easiest to set up.
- Zigbee2MQTT — runs as a separate add-on, more configuration up front, but broader device support and more granular control.
Either way, you need a coordinator. Sonoff sells two:
- ZBDongle-P (CC2652P chip) — supports 200+ devices, the safer default pick.
- ZBDongle-E (EFR32MG21 chip) — supports 100+ devices, slightly cheaper.
Shop Zigbee coordinators
2. WiFi with local LAN mode
Most of Sonoff's WiFi switches (the Mini, Basic, and 4CH series) normally talk to Sonoff's cloud through the eWeLink app. But many of them also support a local LAN mode: once set up through eWeLink, Home Assistant can control them directly over your network with no cloud round-trip, via the community SonoffLAN integration.
This is the right path if you already have WiFi switches, or if a device doesn't have a Zigbee or Matter version yet. It's slightly less "pure local" than Zigbee since initial setup still touches the cloud, but day-to-day control stays on your network.
3. Matter
Newer Sonoff devices like the MINI R4M and M5 Matter speak Matter natively, which Home Assistant supports through its built-in Matter integration. Matter devices pair once and then work across Apple Home, Google Home, Alexa, and Home Assistant simultaneously — useful if your household already uses more than one smart home app.
Which path should you pick?
- Starting from scratch? Go Zigbee. Buy a ZBDongle-P and build out from there — it's the most local, most reliable option long-term.
- Already own Sonoff WiFi switches? Set up SonoffLAN rather than replacing hardware.
- Want one device to work with multiple ecosystems (not just Home Assistant)? Pick Matter.
Getting started with Zigbee (the short version)
- Plug a ZBDongle-P or ZBDongle-E into the Home Assistant host (ideally via a USB extension cable, away from other electronics).
- Install ZHA from Settings → Devices & Services → Add Integration, and select the dongle's serial port. (Prefer Zigbee2MQTT? Install it as an add-on instead and point it at the same port.)
- Put your Sonoff Zigbee device in pairing mode (usually a long-press on its button) and let Home Assistant discover it.
- Repeat for each sensor or switch — every device after the first also extends your mesh's range if it's mains-powered.
Why Home Assistant users choose Sonoff
- Affordable — most devices are $8–$30, so you can build out a whole house without a big up-front cost.
- Proven hardware — widely used in the HA community, with mature integrations and documentation.
- Flexible — Zigbee, WiFi, and Matter options mean you're not locked into one protocol.
- No neutral wire? No problem — the ZBMini L2 is built specifically for older homes without a neutral wire at the switch box.
Popular Zigbee sensors & switches for Home Assistant
More in this series: we're publishing dedicated setup walkthroughs for the ZBDongle, ZBMini, NSPanel, SNZB sensors, and a full ZHA vs. Zigbee2MQTT comparison — check back on the guides page as they go live.





