Skip to main content

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

image.png


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

image.png

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

image.png

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

Back to top