Zigbee2MQTT

Bridge Zigbee devices to MQTT without proprietary hubs.

zigbee mqtt iot smart-home home-automation self-hosted

Ports

Notes

Use Cases

Official Website View on GitHub

About

What Zigbee2MQTT does

Zigbee2MQTT bridges your Zigbee devices to MQTT, allowing them to work with any home automation platform without vendor lock-in. Supports 3000+ Zigbee devices from brands like Philips Hue, IKEA, Aqara, and more. Requires a Zigbee USB coordinator.

Install Flow

How to self-host Zigbee2MQTT

Zigbee2MQTT can be deployed with standard Docker Compose using the Yantr app catalog. This page collects the basic information searchers usually need first: what Zigbee2MQTT does, which Docker image Yantr uses, default ports, deployment notes, and where to find the original compose template.

After deployment, Yantr lets you publish additional ports from the stack page using Docker-style syntax. Use 8080:8080 for a fixed host port or just 8080 to let Docker assign a random port.

Use Cases

What people run it for

Connect Zigbee sensors, bulbs, and switches directly to MQTT.
Integrate hundreds of Zigbee devices with Home Assistant via MQTT.
Eliminate cloud dependency for Zigbee smart home devices.

Technical Details

Ports, image, and service metadata

Ports

Port	Protocol	Label
8080	HTTP	Web UI

Docker Image

koenkk/zigbee2mqtt:latest

Service Name

app

Notes

Things to know before you deploy

A Zigbee USB coordinator (e.g., ConBee II, CC2652) must be attached to the host.
Configure the coordinator USB path in /app/data/configuration.yaml after install.

Related Apps

More tools you might pair with Zigbee2MQTT

PostgreSQL

Open-source relational database with JSON support, full-text search, and extensions.

ZeroClaw

AI assistant gateway with pluggable LLM providers and secure local execution.

OctoPrint

Web interface for monitoring and controlling 3D printers remotely.

Page generated 2026-06-23T15:50:08.758Z