Connecting Zigbee2MQTT on SMHUB to Home Assistant

This guide explains how to connect any  SMHUB Series device to Home Assistant using Zigbee2MQTT . 

 

 Requirements 

 

 

 Any SMHUB model (Essential, Premium, Nano, etc.) 

 

 

 Home Assistant running in your network 

 

 

 Minimum SMHUB firmware: 

 

 

 smhub-os ≥ 0.3.7 

 

 

 smhub-services ≥ 0.2.4 

 

 

 smhub-web ≥ 0.2.18 

 

 

 

 

 

 💡 Tip: You can check and update these versions in the SMHUB web interface 

 

 smhub-os: under  Settings → Updates and Restore . 

 smhub-services and smhub-web: under Apps → Refresh → Upgrade smhub-services and smhub-web . 

 z2m - please update like this: go to Console tab and type ` curl -fsSL https://updates.smlight.tech/z2m.sh | sudo sh `, password is ` smlight `) - this is one-off action, Zigbee23MQTT will be moved to release on 13 December 2025) 

 

 

 

 Connection options 

 You can use Zigbee2MQTT on SMHUB in two ways : 

 

 

 Option 1 (simple): Zigbee2MQTT connects directly to Home Assistant’s MQTT broker 

 

 

 Option 2 (advanced): Zigbee2MQTT uses SMHUB’s local MQTT broker, which is bridged to MQTT on Home Assistant 

 

 

 

 Option 1 – Direct Z2M connection to Home Assistant 

 What to do 

 

 

 Open SMHUB Web UI 

 

 

 Go to Apps → Zigbee2MQTT 

 

 

 Configure the following: 

 

 

 MQTT Broker URL  mqtt: //HOME_ASSISTANT_IP:1883 

 

 

 

 MQTT User / MQTT Password Use your Home Assistant MQTT credentials (often the same as Home Assistant login) 

 

 

 In Home Assistant Settings → Enable 

 

 Enable Experimental Events 

 

 

 

 Then: 

 

 

 Click Save 

 

 

 Stop and start Zigbee2MQTT (or simply reboot SMHUB) 

 

 

 Result 

 

 

 Zigbee2MQTT on SMHUB connects directly to MQTT on Home Assistant 

 

 

 Zigbee devices appear automatically in Home Assistant 

 

 

 Multiple SMHUBs can connect to the same Home Assistant 

 

 

 

 Option 2 – Local MQTT on SMHUB with bridge to Home Assistant's MQTT 

 What to do 

 

 

 Open SMHUB Web UI 

 

 

 Go to Apps → Zigbee2MQTT 

 

 

 Enable Home Assistant Settings 

 

 

 Click Save 

 

 

 

 Then configure MQTT bridge: 

 

 

 Go to Settings → MQTT 

 

 

 Set the following: 

 

 

 Allow External → Enabled. This lets the remote broker send MQTT messages to SMHUB's broker.  

 

 

 Allow Anonymous → Enabled (simplest option) - but be careful. You can tweak this by adding credentials and making the respective settings on the remote broker.  

 

 

 Enable Bridge Mode → True 

 

 

 Remote broker settings: 

 

 

 Remote Address  HOME_ASSISTANT_IP:1883 

 

 

 

 MQTT User / MQTT Password Home Assistant MQTT credentials 

 

 

 Bridge Topic  # both 1 

 

 

 

 

 Then: 

 

 

 Click Save 

 

 

 Reboot SMHUB (recommended) 

 

 

 Result 

 

 

 SMHUB keeps its own MQTT broker 

 

 

 MQTT data is bridged to Home Assistant 

 

 

 Zigbee devices appear in Home Assistant 

 

 

 Multiple SMHUBs can connect to one Home Assistant 

 

 

 

 Which option should I choose? 

 

 

 Choose Option 1 if you want the simplest and fastest setup 

 

 

 Choose Option 2 only if you need local MQTT on SMHUB