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
GitHub	Koenkk/zigbee2mqtt
License	GPL-3.0
Langage	TypeScript
Étoiles GitHub	14k ⭐
Catégorie	[[cat-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é)

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

# 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

Pages Liées

cat-internet-of-things — Catégorie IoT
app-mosquitto — Broker MQTT
recettes-docker-compose — Templates Docker

4.0 KiB Raw Blame History