---
title: Zigbee2MQTT
created: 2026-06-08
updated: 2026-06-08
type: app
tags: [catalogue, internet-of-things, mqtt, zigbee, domotique, app-marathon3-rattrapage-a]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=IoT, https://zigbee2mqtt.io/]
---

# 🔌 Zigbee2MQTT

> **Pont Zigbee vers MQTT** : pilotez 3000+ appareils Zigbee (Xiaomi, IKEA, Philips Hue, Sonoff) sans dépendance cloud — un seul dongle USB suffit.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [zigbee2mqtt.io](https://zigbee2mqtt.io/) |
| **GitHub** | [Koenkk/zigbee2mqtt](https://github.com/Koenkk/zigbee2mqtt) |
| **License** | GPL-3.0 |
| **Langage** | TypeScript |
| **Étoiles GitHub** | 14k ⭐ |
| **Catégorie** | [[cat-internet-of-things|Internet of Things]] |

## 📝 Description

**Zigbee2MQTT** est né en 2017 du projet personnel de **Koen Kanters (Koenkk)**, frustré par la nécessité d'avoir un hub propriétaire par marque. Il permet d'utiliser un **seul coordinateur Zigbee** (clé USB) pour piloter des appareils de toutes marques.

Fonctionnalités :
- ✅ **3000+ appareils Zigbee supportés** : Xiaomi/Aqara, IKEA Tradfri, Philips Hue, Sonoff, OSRAM, Sengled, Innr, Gledopto...
- ✅ **Coordinateurs supportés** : Texas Instruments CC2652, ConBee II, RaspBee, ZBDongle-E, ZBDongle-P
- ✅ **Appairage via interface web** (Zigbee2MQTT-frontend)
- ✅ **Topic MQTT standard** : `zigbee2mqtt/<device>` publish/subscribe
- ✅ **OTA updates** : mises à jour firmware des appareils depuis l'UI
- ✅ **Groupes, scènes, bindings** Zigbee natifs
- ✅ **Touchlink** : appairage par proximité
- ✅ **Home Assistant auto-discovery** : aucune config manuelle
- ✅ **Logging avancé** : debug, sniffer réseau

**Différence vs deCONZ/ZHA** : Zigbee2MQTT = projet indépendant plus complet et réactif, expose tout en MQTT (pas de daemon propriétaire). ZHA = intégration Home Assistant native, moins d'appareils supportés.

**Pour qui** : amateurs de domotique, labs smart-home, intégrateurs, et toute personne qui veut s'affranchir des écosystèmes cloud Xiaomi/Hue.

## 🚀 Installation

### Docker Compose (recommandé)

```yaml
version: '3.8'
services:
  zigbee2mqtt:
    image: koenkk/zigbee2mqtt:latest
    container_name: zigbee2mqtt
    restart: unless-stopped
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # dongle Zigbee
    ports:
      - "8080:8080"  # Frontend web
    environment:
      - TZ=Europe/Paris
    volumes:
      - ./data:/app/data
      - run/udev:/run/udev:ro
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.z2m.rule=Host(`zigbee.example.com`)"
      - "traefik.http.routers.z2m.tls.certresolver=letsencrypt"
    depends_on:
      - mosquitto
```

### Configuration initiale

```yaml
# data/configuration.yaml
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://mosquitto:1883
  user: mqtt_user
  password: changeme
serial:
  port: /dev/ttyUSB0
  adapter: zstack
frontend:
  port: 8080
```

## 🔄 Alternatives

### Open Source
- [[app-mosquitto]] — broker MQTT
- [[app-z-wave-js-ui]] — pont Z-Wave
- **deCONZ** — passerelle ConBee officielle Phoscon
- **ZHA** — intégration Home Assistant native
- **ioBroker** — multi-protocole domotique

### Propriétaires
- **Philips Hue Bridge** — fermé, app Hue obligatoire
- **Xiaomi Mi Hub** — cloud-only, latence élevée
- **SmartThings Hub** — écosystème Samsung

## 🔐 Sécurité
- **Chiffrement Zigbee 3.0** natif (AES-128)
- **Clé réseau** Zigbee2MQTT : `network_key` dans `configuration.yaml`
- **Pairing sécurisé** : `permit_join: false` par défaut
- **Réseau local** : aucune donnée Zigbee envoyée au cloud
- **Mises à jour régulières** : suivre la branche `dev` pour les correctifs

## 📚 Ressources
- [Documentation](https://www.zigbee2mqtt.io/guide/)
- [GitHub](https://github.com/Koenkk/zigbee2mqtt)
- [Liste des appareils supportés](https://www.zigbee2mqtt.io/supported-devices/)

## Pages Liées
- [[cat-internet-of-things]] — Catégorie IoT
- [[app-mosquitto]] — Broker MQTT
- [[recettes-docker-compose]] — Templates Docker
