How do I set up Zigbee2MQTT with Home Assistant?

Use the official Home Assistant addon for Hass.io installations or follow the integration guide in the Zigbee2MQTT documentation to configure MQTT discovery and device mapping for other setups.

Zigbee2MQTT vs Philips Hue bridge: which is better for customization?

Zigbee2MQTT offers full local control and supports devices from multiple brands via MQTT, making it highly customizable, while the Philips Hue bridge is easier to use but locked to Hue ecosystem and cloud features.

How to add an unsupported Zigbee device to Zigbee2MQTT?

Check if a converter exists in the zigbee-herdsman-converters repository; if not, you can contribute by following the guide on supporting new devices, which involves mapping device clusters to MQTT topics.

Does Zigbee2MQTT work with Xiaomi Aqara sensors?

Yes, many Xiaomi Aqara sensors are supported through community converters, but you should verify in the supported devices list and may need specific pairing procedures due to Xiaomi's proprietary extensions.

How to troubleshoot Zigbee2MQTT connectivity issues?

Check adapter compatibility, ensure the Zigbee network is properly configured via the web interface, and review MQTT broker logs; the documentation includes troubleshooting steps for common problems like interference or device pairing failures.

Zigbee2MQTT or Z-Wave: which should I choose for a new smart home?

Zigbee2MQTT is ideal for Zigbee devices with local control and vendor independence, while Z-Wave offers similar benefits but with a different protocol; choose based on device availability, cost, and existing infrastructure.

zigbee2mqtt — Zigbee to MQTT Bridge

What is zigbee2mqtt?

Zigbee2MQTT is an open-source software bridge that translates communication between Zigbee smart home devices and an MQTT broker. It allows users to connect and control Zigbee devices like lights, sensors, and switches directly through their own MQTT-based home automation system, bypassing the need for manufacturer-specific hubs.

Target Audience

DIY smart home enthusiasts, home automation tinkerers, and privacy-conscious users who want to integrate Zigbee devices into custom or open-source home automation platforms like Home Assistant, Domoticz, or ioBroker.

Value Proposition

It provides complete local control, avoids vendor lock-in, supports a vast array of devices from different brands, and integrates seamlessly with virtually any MQTT-compatible system, offering unparalleled flexibility compared to proprietary ecosystems.

Overview

Zigbee 🐝 to MQTT bridge 🌉, get rid of your proprietary Zigbee bridges 🔨

Use Cases

Best For

Building a vendor-agnostic Zigbee smart home network
Integrating Zigbee devices into Home Assistant without proprietary hubs
Adding unsupported or custom Zigbee devices to an existing setup
Achieving local-only smart home automation for enhanced privacy
Replacing multiple manufacturer gateways with a single, unified solution
Developing custom integrations for Zigbee devices via MQTT

Not Ideal For

Home users who want plug-and-play smart devices with vendor apps and no technical setup
Projects that rely entirely on cloud-based ecosystems and prefer minimal local configuration
Teams with limited time or expertise to configure and maintain an MQTT broker and Zigbee network

Pros & Cons

Pros

Vendor Independence

Eliminates the need for proprietary bridges from manufacturers like Philips and Xiaomi, allowing direct control without vendor gateways, as highlighted in the project description.

Extensive Device Support

Supports a wide range of Zigbee devices through community-driven converters, with a documented list including brands like IKEA and OSRAM, enabling broad compatibility.

Flexible MQTT Integration

Bridges Zigbee events to MQTT for seamless integration with home automation platforms like Home Assistant and Domoticz, as shown in the integrations section.

Local Control and Privacy

Designed for full local operation without cloud dependency, promoting data privacy and freedom from vendor lock-in, in line with the project's philosophy.

Cons

Complex Initial Setup

Requires configuring a compatible Zigbee USB adapter, an MQTT broker, and detailed settings, which can be daunting, as implied by the extensive getting started guide.

Community-Dependent Device Support

New device additions rely on volunteer contributions in the zigbee-herdsman-converters module, meaning support for the latest devices may lag or require manual effort.

Technical Knowledge Required

Demands understanding of Zigbee networks, MQTT protocols, and home automation systems, with documentation that assumes prior knowledge in areas like network configuration.

Open Source Alternative To

zigbee2mqtt is an open-source alternative to the following products:

X

Xiaomi Gateway

Samsung SmartThings Hub

Samsung SmartThings Hub is a home automation hub that connects and controls smart devices like lights, locks, and sensors through the SmartThings ecosystem.

Philips Hue Bridge

Philips Hue Bridge is the central control device for Philips Hue smart lighting systems, connecting Hue bulbs to home networks and enabling app control.

I

IKEA Tradfri Gateway

IKEA Trådfri Gateway is a smart home hub that connects IKEA's smart lighting products to a home network for remote control via mobile app.

zigbee2mqtt

What is zigbee2mqtt?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions

Related Projects

Found a gem we're missing?

zigbee2mqtt

What is zigbee2mqtt?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions

Related Projects

Found a gem we're missing?