# 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:<span class="hljs-comment">//HOME_ASSISTANT_IP:1883</span>`
- **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](https://smlight.tech/support/manuals/uploads/images/gallery/2025-12/scaled-1680-/EfNimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-12/EfNimage.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](https://smlight.tech/support/manuals/uploads/images/gallery/2025-12/scaled-1680-/4Ijimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-12/4Ijimage.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** `<span class="hljs-section">HOME_ASSISTANT_IP:1883</span>`
- **MQTT User / MQTT Password**  
    Home Assistant MQTT credentials
- **Bridge Topic** `<span class="hljs-meta"># both 1</span>`

[![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2025-12/scaled-1680-/6zOimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-12/6zOimage.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