Zigbee2MQTTZigbee2MQTT
  • Getting started
  • Supported Adapters
  • Supported Devices
  • Installation
  • Configuration
  • Usage
  • FAQ
Devices
  • Zigbee

    • Zigbee network
    • Improve network range and stability
    • Secure your Zigbee network
    • Sniff Zigbee traffic
    • Create a CC2530 router
  • Support new devices

    • Support new devices
    • Support new Tuya devices
    • Find Tuya Data Points
  • Remote Adapter

    • Connect to a remote adapter
    • Connect to a remote Sonoff ZBBridge
  • More

    • 3D cases
    • External converters
    • External extensions
    • Switch to the dev branch
    • Get Tuya and Xiaomi OTA url
  • Forum
  • Discord
  • Issues
  • Donate
GitHub
GitHub (docs)
  • Getting started
  • Supported Adapters
  • Supported Devices
  • Installation
  • Configuration
  • Usage
  • FAQ
Devices
  • Zigbee

    • Zigbee network
    • Improve network range and stability
    • Secure your Zigbee network
    • Sniff Zigbee traffic
    • Create a CC2530 router
  • Support new devices

    • Support new devices
    • Support new Tuya devices
    • Find Tuya Data Points
  • Remote Adapter

    • Connect to a remote adapter
    • Connect to a remote Sonoff ZBBridge
  • More

    • 3D cases
    • External converters
    • External extensions
    • Switch to the dev branch
    • Get Tuya and Xiaomi OTA url
  • Forum
  • Discord
  • Issues
  • Donate
GitHub
GitHub (docs)
  • Connect to a remote adapter
  • Connect to a remote Sonoff ZBBridge

Connect to a remote Sonoff ZBBridge

This how-to explains how to run Zigbee2MQTT with a commercial Sonoff ZBBridge Gateway. We will use a Sonoff ZBBridge Gateway with custom firmware to connect to a serial port over TCP. In this way you can use a simple premade Hub/Gateway flash it with custom firmware and then use it as your coordinator.

Warning

Keep in mind that the EZSP support is currently experimental.

Warning

WiFi-based Serial-to-IP bridges are not recommended as the serial protocol does not have enough fault-tolerance to handle packet loss or latency delays that can normally occur over WiFi connections.

1. Flash Tasmota ZBBridge

In order for the gateway to be useful for us we want it flashed with custom firmware (tasmota-zbbridge) so we can free ourselves from the cloud. For flashing procedure follow DigiBlurs guide up until step 6.

2. Configure

Now edit the Zigbee2MQTT configuration.yaml accordingly, replace 192.168.2.13 with the IP or hostname of your system where the adapter is connected to. Also replace 20108 with the port you configured while flashing the Gateway (in step 6 from previous point).

Keep in mind that the EZSP support is currently experimental.

serial:
    port: 'tcp://192.168.2.13:20108'
    adapter: ezsp

Done! Now you can start Zigbee2MQTT.

Help to make the docu better and edit this page on Github ✌
Last Updated:: 5/21/25, 7:56 PM
Prev
Connect to a remote adapter