Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,119 @@
+---
+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