How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT

Aug 28, 2026

By Joanna Z

How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT

Introduction

SONOFF is introducing OpenEdge, a local-first architecture for next-generation smart devices, designed to give you greater local control, broader interoperability, and more flexible ways to connect your devices across different platforms and ecosystems.

With OpenEdge, supported SONOFF devices can communicate locally via open interfaces including HTTP, MQTT, and WebSocket.

For Home Assistant users, this means more choice in how you integrate your devices: you can connect them locally via MQTT when you prefer local control and flexible ecosystem integration, while cloud connectivity remains available when it better fits your needs.

In this guide, you'll learn how to integrate SONOFF OpenEdge-enabled devices with Home Assistant via MQTT through a detailed step-by-step setup.

How MQTT Integration with Home Assistant Works

Before you start configuring MQTT, it helps to understand how the connection works.

The basic architecture looks like this:

OpenEdge-enabled SONOFF device → MQTT Broker → Home Assistant

The SONOFF device does not connect directly to Home Assistant. Instead, both the device and Home Assistant connect to the same MQTT broker, which acts as the message hub between them.

OpenEdge-enabled SONOFF device — Connects to the broker as an MQTT client, publishes device states and data, and receives control commands.
MQTT broker — Receives and distributes MQTT messages between connected clients. In Home Assistant setups, Mosquitto is a common choice.
Home Assistant — connects to the same broker via the MQTT integration, receives device updates, sends commands, and manages the device in Home Assistant.

OpenEdge-enabled SONOFF devices with MQTT natively support MQTT Discovery. Once the device connects to the broker, it publishes the required discovery information, allowing Home Assistant to automatically create the supported device and entities without manually configuring MQTT topics or writing YAML.

Set Up OpenEdge Devices with Home Assistant via MQTT

Now let's set up the MQTT integration. This guide uses the SONOFF MINI-1GSP as an example, while the same basic workflow can be used for other compatible OpenEdge devices with MQTT support.

What You'll Need

Before you begin, make sure you have:

An OpenEdge-enabled SONOFF device with MQTT support.
Home Assistant is installed and running.
An MQTT broker is installed and running.
The MQTT integration was added and connected to the broker in Home Assistant.

Install and Set Up an MQTT Broker

If you don't already have an MQTT broker, a common option for Home Assistant is the official Mosquitto MQTT broker app.

To install it in Home Assistant:

Open Home Assistant.
Go to Settings → Apps (formerly known as add-ons) → Install app.
Search for Mosquitto broker and click INSTALL.
Once installed, start the Mosquitto broker app.
It is recommended to enable Start on boot and Watchdog, so the broker starts automatically with Home Assistant and can be restarted if it stops unexpectedly.
If needed, create a dedicated Home Assistant user for MQTT devices under Settings → People → Users.

For more details about choosing and configuring an MQTT broker, see Home Assistant's official setting up a broker guide.

Add the MQTT Integration in Home Assistant

In Home Assistant, go to Settings → Devices & Services → Add Integration.
Search for MQTT and complete the setup.
Go to Settings → Devices & Services → MQTT to confirm that the integration is connected to your broker.

Step 1: Power On the Device

For the MINI-1GSP, the device automatically enters pairing mode on first power-up. When the LED shows two short flashes followed by one long flash, its AP hotspot is ready for setup.

Step 2: Access the OpenEdge Web Console

There are two ways to access the Web Console.

Method 1: Access via AP Hotspot — Recommended for First-Time Setup

Open the Wi-Fi settings on your desktop, tablet, or mobile device.
Connect to the device hotspot: SONOFF_1GSP_xxxx.

Open a web browser and navigate to: http://192.168.33.1
The Web Console login page will open. The first time you access it, create a login password of at least 8 characters.
Log in to enter the OpenEdge Web Console.

From the Web Console, you can manage local functions including ON/OFF control, historical energy data, timers, Matter Pairing, Network Settings, AP/Wi-Fi configuration, OTA updates, and About OpenEdge.

Under Connectivity Settings, you can configure Cloud connectivity, MQTT for Home Assistant, TLS options, and outbound WebSocket connections for third-party platforms.

Method 2: Access via LAN

If the device is already connected to your local network, you can access the Web Console directly without connecting to its AP hotspot.
For the MINI-1GSP, open a browser on a device that can reach the same LAN, enter either of the following in your browser:

MINI-1GSP.local
The device's local IP address.

Step 3: Connect the Device to Your Wi-Fi Network

Connect the device to a Wi-Fi network that can reach both Home Assistant and your MQTT broker, so they can communicate over the local network.

Go to Network Settings → Wi-Fi Settings.
Select the Wi-Fi network that you can access from Home Assistant and the MQTT broker.
Enter the Wi-Fi password.
Click Save.
Wait for the device to connect.

Once the device connects to your local network, your router will typically assign it a local IP address via DHCP. This address is shown in the Wi-Fi settings and can be used for later LAN access to the Web Console, as described in Method 2 above.

Note: AP Hotspot Timeout

The MINI-1GSP automatically exits pairing mode after about 10 minutes. When pairing mode ends, the AP hotspot used for first-time setup is no longer available.

If the AP hotspot disappears before you finish the setup:

If the device is already connected to your local network, continue the setup through the LAN access method described above.
If you need to use the AP hotspot again, press and hold the device button for 5 seconds to re-enter pairing mode.
Reconnect to SONOFF_1GSP_xxxx, open http://192.168.33.1, and continue the setup.

Tip: Pressing and holding the device button for 10 seconds performs a factory reset.

Step 4: Enable MQTT and Configure the Parameters

Go to Connectivity Settings → MQTT.
Enable MQTT.
Configure the MQTT parameters as shown below
When the settings are complete, click Save.

Device Web Console MQTT Configuration Example:

Setting	What to Enter
Server	MQTT broker address and port, e.g. `192.168.1.242:1883`
Username	MQTT broker username
Password	MQTT broker password
Connection Type	Select the TLS option that matches your broker
RPC status notifications over MQTT	Enable or disable as needed

Tips:

The Server field should point to your MQTT broker. If Mosquitto Broker is running on the same host as Home Assistant, this is typically the Home Assistant host IP address with MQTT port 1883, for example: 192.168.1.242:1883.
If you're using the official Home Assistant Mosquitto Broker and haven't created separate MQTT credentials (username and password), you can use an existing Home Assistant username and password.
If Mosquitto is already configured with a username and password, enter the same username and password in the device's Web Console MQTT settings.

Step 5: Verify and Control the Device in Home Assistant

After saving the MQTT settings, reconnect your desktop, tablet, or mobile device to the local network that can access Home Assistant and the MQTT broker.
Open Home Assistant, go to Settings → Devices & Services → MQTT

The device should already appear in the MQTT device list. OpenEdge-enabled SONOFF devices with MQTT support natively publish Home Assistant MQTT Discovery information, allowing Home Assistant to automatically add the device and create its supported entities without manual MQTT topic or YAML configuration.

Open the device page to view its available controls and entities. For the MINI-1GSP example, these include functions such as:
- Relay control
- Current
- Voltage
- Power
- Frequency
- Energy data

You can then add these entities to your Home Assistant dashboard or use them in automations and scenes.

OpenEdge-Supported Devices

The following SONOFF products currently support OpenEdge:

More OpenEdge-enabled devices are coming soon, including:

MINI-1GS
MINI-1GS10
……

OpenEdge will also gradually expand to more SONOFF product categories, including:

Smart switches — enabling more flexible local control and integration through open interfaces.
Energy management products — bringing local data processing and more transparent energy monitoring.
Other smart devices — connecting with more platforms and ecosystems through OpenEdge's open integration capabilities.

👉 For the latest supported devices and the features available after integration with Home Assistant, see the Home Assistant Feature Support List for SONOFF OpenEdge devices.

Conclusion

SONOFF OpenEdge makes Home Assistant integration simpler, more local, and more flexible. Through the built-in Web Console and OpenEdge's standardized Local API over MQTT, supported SONOFF devices can be configured directly from a browser and integrated locally with Home Assistant — bringing straightforward setup, responsive local control, and more flexible automation without relying on the cloud for the integration path.

FAQs

Q: Does OpenEdge require the cloud?

Not necessarily. OpenEdge is designed around a local-first architecture, allowing supported devices to be configured, controlled, and integrated through the local Web Console and standardized Local API over the local network.

Cloud connectivity is not required for these local capabilities, but it remains available as an optional enhancement for features and services that benefit from cloud access.

Q: Can SONOFF OpenEdge devices work with Home Assistant when the internet is unavailable?

Yes. For the Home Assistant MQTT setup described in this guide, the SONOFF device, MQTT broker, and Home Assistant must remain reachable over the local network.

As long as the LAN and MQTT broker remain available, the device can continue communicating with Home Assistant locally without an active internet connection.

Q: Do I need the eWeLink app or an eWeLink account to set up MQTT with Home Assistant?

No. For the local MQTT integration described in this guide, you can access the OpenEdge Web Console directly from a browser without using the eWeLink app or an eWeLink account.

For initial setup, you can access the Web Console through the device's AP hotspot. Once the device has joined your local network, you can also access it over the LAN using its local hostname or IP address.

From the Web Console, you can configure the device network and MQTT connection directly. eWeLink cloud connectivity remains available separately if you choose to use it.