← Directory

Zigbee2MQTT

Zigbee2MQTT is a self-hosted Zigbee-to-MQTT bridge that lets home-automation users control Zigbee devices without vendor hubs by exposing device state and…

  • Automation
  • Home Automation
  • Other
  • Tools & Utilities
Zigbee2MQTT is a self-hosted Zigbee-to-MQTT bridge that lets home-automation users control Zigbee devices without vendor hubs by exposing device state and commands over MQTT.

Platform availability

Available on 6 of 9 platforms

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

39/100 Low

Maintained
0GitHub repository no longer exists
Popular
No data
Easy to install
856 install platforms, install notes, Docker image
Light to run
801 GB minimum RAM, runs on ARM

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 16 days ago

No GitHub repository data collected yet.

Checked 17 days ago - source: GitHub (BigBearTechWorld/zigbee2mqtt)

Resources & Compatibility

Minimum requirements: 1 GB RAM, 8 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 17 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fill in the config before starting Edit configuration.yaml so the MQTT server (the message server other apps use) points to your broker and the serial port points to your USB Zigbee stick. Leave GENERATE for the network keys if this is a new Zigbee network, because wrong values can stop devices from joining. source
  • Start it from the installation folder Open a terminal, go to the Zigbee2MQTT install folder, and run the start command shown for your system, such as pnpm start. If you skip this step, the app is not running and no devices can be paired or controlled. source
  • Look for a successful startup log After starting, watch for lines like 'zigbee-herdsman started' and 'Connected to MQTT server'. These confirm it found your Zigbee stick and MQTT broker; missing them usually means a bad serial port, wrong MQTT address, or a startup failure. source
  • Configure adapter and MQTT Set serial_port in configuration.yaml to your adapter’s serial path (for example /dev/serial/by-id/...) or TCP port, and set the MQTT host. source

Fetched 9 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What do I need to set in configuration.yaml before starting a new Zigbee2MQTT network?

Point the MQTT server setting to your broker and set the serial port to your USB Zigbee stick. Leave GENERATE for the network keys if this is a new Zigbee network, because wrong values can stop devices from joining.

How can I tell from the logs that Zigbee2MQTT started successfully?

Look for lines such as 'zigbee-herdsman started' and 'Connected to MQTT server'. If those are missing, it usually means a bad serial port, wrong MQTT address, or a startup failure.

How do I reset a Zigbee device that was used on another network before pairing it?

Use the device’s reset procedure to remove its previous network binding. In the shared example, the user plugged the bulb in and performed a six times on/off cycle.

Does Zigbee2MQTT support devices that only use the Zigbee Smart Energy profile?

No, Zigbee2MQTT does not currently support devices that can only use the ZSE profile. That limitation is because the Zigbee SE specification is not part of the standard Zigbee 3.0 specification it follows.

Answers sourced from www.reddit.com, www.zigbee2mqtt.io, www.zigbee2mqtt.io, www.zigbee2mqtt.io

Community

Collected 16 days ago - public community threads