Install Zigbee2MQTT after ZHA

Configuration Zigbee
,
1

Hi,

Please be gentle, this is my first post and I already tried google and 3 AI agents and i’ve been going in circles for a few days now.
What I’m trying to do is install Zigbee2MQTT on a Home Assistant green device that already has ZHA working with no issues, but I’m getting stuck and I honestly don’t know where to start debugging.
My current setup is: Home Assistant Green + Home Assistant Sky connect ZBT-1 for ZHA.
I’ve bought ZBT-2 and plugged it into my other Home Assistant Green USB (2/2 are occupied)
I created a user for MQTT, Local access only, Administrator (i’m not sure this is required)
I added Mosquitto broker. Logins - added the user created before.

LOG:
[03:00:31] INFO: Successfully send discovery information to Home Assistant.
[03:00:32] INFO: Successfully send service information to the Supervisor.
...
2025-12-27 03:12:19: Client <unknown> closed its connection.

I installed Zigbee2MQTT, settings:

data_path: /config/zigbee2mqtt
socat:
  enabled: false
  master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777
  slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5
  options: "-d -d"
  log: false
mqtt:
  server: mqtt://core-mosquitto:1883
  base_topic: zigbee2mqtt
  user: mqttuser
  password: ***
serial:
  port: /dev/serial/by-id/usb-Nabu_Casa_ZBT-2_9C139EAB6DC8-if00
  adapter: ember

I click to open Web UI but i get “Zigbee2MQTT Onboarding” instead of the nice interface every tutorial gets…

Can you give me some advice on what should I look for?

2

What do the Zigbee2MQTT logs say? You can see them either through the add-on page or Settings → System - Logs and then selecting Zigbee2MQTT through the dropdown.

3

I think that’s somewhat expected since the onboarding page is where you fill in other setup details, like the zigbee channel.
Did you ensure you filled in all fields in the onboarding page?

4

Hi, welcome to the forum!

Are you running ZHA and Z2M at the same time?
I don’t know if that can be done so maybe someone else can comment on that…

5

As long as you run them with their own coordinator, it’s fine. I run ZHA and Zigbee2MQTT in the same HA instance. Each has it’s own SLZB-06 coordinator.

1 Like
6

This is the MQTT Log right?
For what its worth, if you are using the MQTT AddOn w. HAOS, then by default you don’t need to configure any mqtt stuff. In Z2M the config can be: mqtt: {}.
However since you have created a user in the MQTT Broker, don’t forget to somehow tell HA Core that it too needs this username/password.