[{"_1":2,"_175":-5,"_176":-5},"loaderData",{"_3":4,"_18":19,"_25":26,"_152":153},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":11,"_24":22},"username","isAskGordonEnabled",true,"showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_92":-5,"_93":94,"_140":-5,"_141":11,"_142":22,"_143":11,"_144":11,"_145":-5,"_146":11,"_147":-5,"_148":149,"_150":95,"_151":-7},"canonicalUrl","https://hub.docker.com/r/jcpd/dknr-zigbee/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","jcpd","reponame","dknr-zigbee","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_47":48,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":60,"_43":35,"_32":33,"_62":63,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":78,"_83":11,"_84":85,"_89":33,"_90":91},"categories",[42],{"_43":44,"_45":46},"name","Internet of things","slug","internet-of-things","content_types",[49],"image","date_registered","2026-10-28T18:25:27.723058Z","description","Zigbee web UI and MQTT connector for DKNR app","is_private","last_updated","2026-11-04T13:13:20.160332Z","last_modified","2026-11-02T21:59:49.797838Z","media_types",[61],"application/vnd.oci.image.index.v1+json","pull_count",462,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# README\n\n[![Release](https://img.shields.io/docker/v/jcpd/dknr-zigbee?sort=semver)](https://img.shields.io/docker/v/jcpd/dknr-zigbee?sort=semver)\n[![Pull](https://img.shields.io/docker/pulls/jcpd/dknr-zigbee)](https://img.shields.io/docker/pulls/jcpd/dknr-zigbee)\n[![Issue](https://img.shields.io/github/issues/jcdenis/dknr-zigbee)](https://img.shields.io/github/issues/jcdenis/dknr-zigbee)\n[![License](https://img.shields.io/github/license/jcdenis/dknr-zigbee)](https://github.com/JcDenis/dknr-zigbee/blob/master/LICENSE)\n\n\n## A propos\n\n**dknr-zigbee** est un projet consacré au pilotage, à la récupération et à l'exploitation des données des appareils Zigbee en local. Ce projet s'appuie sur [Zigbee2MQTT](https://www.zigbee2mqtt.io/), qui gère la clé Zigbee et le réseau, et reprend ses appareils dans la même arborescence MQTT que les autres projets DKNR.\n\n\n## Fonctionnalités\n\n- **Tous les appareils supportés par Zigbee2MQTT** : capteurs, prises, interrupteurs, ampoules, volets, vannes thermostatiques, télécommandes...\n- **Entités construites automatiquement** à partir de la description (exposes) de chaque appareil : valeurs numériques, états, listes de choix, textes.\n- **Identifiant stable** : un appareil est identifié par son adresse IEEE, le renommer dans Zigbee2MQTT ne change ni ses topics ni ses entités Home Assistant.\n- **Pilotage** de toutes les valeurs modifiables (allumer, éteindre, inverser, luminosité, consigne, mode...).\n- **Réseau** : état du pont Zigbee2MQTT, liste des appareils (qualité du signal, batterie, dernier signal, disponibilité), autorisation de l'appairage, renommage et suppression d'un appareil.\n- **Support Home-Assistant Discovery** en lecture et pilotage des appareils (capteurs, interrupteurs, nombres, sélecteurs, textes), y compris le pont lui-même.\n\n\n## Matériel requis\n\nLe matériel exact dépend de l'installation, mais l'utilisation du projet nécessite généralement :\n\n* une clé ou un coordinateur Zigbee [compatible Zigbee2MQTT](https://www.zigbee2mqtt.io/guide/adapters/).\n* un serveur MQTT, utilisé à la fois par Zigbee2MQTT et par ce projet.\n* une machine exécutant le logiciel docker.\n\n\n## Installation\n\nDes images Docker prêtes à l'emploi sont disponibles.\nLe fichier docker-compose.yaml à la racine du dépôt lance **Zigbee2MQTT** et **DKNR Zigbee**. Fournissez les variables d'environnement suivantes :\n\n* **DKNR_USERNAME** : login de l'interface node-red.\n* **DKNR_PASSWORD** : mot de passe de l'interface node-red.\n* **DKNR_SECRET** : un mot secret pour encrypter les credits.\n\nAdaptez si besoin le port série de la clé Zigbee (`/dev/ttyUSB0`) et configurez le serveur MQTT dans le fichier `configuration.yaml` de Zigbee2MQTT (volume `data`).\n\nLe tableau de bord DKNR est disponible sur `http:///`, l'éditeur Node-RED sur `http:///admin` et l'interface de Zigbee2MQTT sur `http://:1880/`.\n\n\n## Configuration\n\n### MQTT\n\nDans la page **Configurer** :\n\n* **Adresse IP**, **port**, **utilisateur** et **mot de passe** du serveur MQTT, le même que celui de Zigbee2MQTT.\n* **Topic** : racine des topics DKNR (`dknr` par défaut).\n* **Zigbee2MQTT topic** : `base_topic` de Zigbee2MQTT (`zigbee2mqtt` par défaut).\n* **Home Assistant Discovery topic** : laissez vide pour ne pas publier la discovery Home Assistant.\n\n### Zigbee2MQTT\n\nQuelques réglages de Zigbee2MQTT améliorent le fonctionnement du projet :\n\n* **Disponibilité des appareils** (`availability: enabled: true`) : ajoute l'entité *Disponibilité* et rend les entités Home Assistant indisponibles quand l'appareil ne répond plus.\n* **Dernier signal** (`advanced: last_seen: ISO_8601`) : ajoute l'entité *Dernier signal*.\n* **Home Assistant** : si l'intégration Home Assistant de Zigbee2MQTT est aussi activée, chaque appareil apparaîtra deux fois dans Home Assistant. Désactivez l'une des deux discovery.\n\n### Appairer un appareil\n\nDans la page **Réseau**, cliquez sur **Autoriser** (254 secondes au maximum) puis mettez l'appareil en mode appairage. Il apparaît dans la liste dès que Zigbee2MQTT l'a interrogé.\n\n\n## MQTT\n\nAvec le topic `dknr` par défaut, l'identifiant d'un appareil est son adresse IEEE sans `0x` (ex : `00158d0001a2b3c4`) et le nom d'une entité est la propriété Zigbee2MQTT (ex : `temperature`, `state`, `state_l1`) :\n\n* `dknr/get/zigbee//` : valeurs publiées (retenues, sauf `action`) à chaque changement. Les états binaires valent `1` ou `0`, y compris les listes à deux états de type arrêt / marche (ex : `idle` / `occupied`).\n* `dknr/set/zigbee//` : commande, `1`, `0` ou `TOGGLE` (`ON` et `OFF` sont aussi acceptés) pour un état binaire, un nombre ou une valeur de la liste pour les autres.\n* La couleur des ampoules (espace x,y ou teinte / saturation de Zigbee2MQTT) est publiée et pilotée en hexadécimal `#rrggbb` (unité `chex`) sur l'entité `color`, à pleine luminosité. La luminosité reste sur l'entité `brightness`.\n* `dknr/discovery/zigbee//` : description des entités.\n* `homeassistant//zigbee/_/config` : Home Assistant Discovery.\n\nLe pont Zigbee2MQTT est publié comme un appareil d'identifiant `bridge` : `state` (en ligne), `permit_join` (appairage, pilotable) et `version`.\n\nLes entités *Disponibilité* (`availability`) et *Dernier signal* (`last_seen`) sont ajoutées dès que Zigbee2MQTT les publie.\n\nAu démarrage, l'état des appareils alimentés sur secteur est relu une fois s'il n'est pas déjà connu. Les appareils sur pile ne répondent qu'à leur réveil.\n\n\n## A faire\n\n* Entités Home Assistant *light*, *cover* et *climate* complètes (les fonctions sont aujourd'hui publiées séparément : état, luminosité, position, consigne...).\n* Couleur des ampoules (valeurs composées `color_xy`, `color_hs`).\n* Groupes Zigbee2MQTT.\n\n\n## Contribuer\n\nCe projet est **open-source**, vous pouvez participer en créant des [tickets](https://github.com/JcDenis/dknr-zigbee/issues) ou en proposant de [requêtes](https://github.com/JcDenis/dknr-zigbee/pulls) sur le dépôt github du projet.\n\n\n## Voir aussi\n\n- [DKNR Teleinfo](https://github.com/JcDenis/dknr-teleinfo)\n- [DKNR APSystems](https://github.com/JcDenis/dknr-apsystems)\n- [DKNR Daikin](https://github.com/JcDenis/dknr-daikin)\n- [DKNR Zendure](https://github.com/JcDenis/dknr-zendure)\n- [DKNR RFXCom](https://github.com/JcDenis/dknr-rfxcom)\n- [DKNR Nuki](https://github.com/JcDenis/dknr-nuki)\n- [Zigbee2MQTT : topics et messages MQTT](https://www.zigbee2mqtt.io/guide/usage/mqtt_topics_and_messages.html)\n- [Zigbee2MQTT : exposes](https://www.zigbee2mqtt.io/guide/usage/exposes.html)\n","has_starred","hub_user","immutable_tags_settings",{"_79":11,"_80":81},"enabled","rules",[82],".*","is_automated","permissions",{"_86":22,"_87":11,"_88":11},"read","write","admin","user","storage_size",1008821255,"orgData","recentTags",[95],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_55":129,"_130":98,"_131":33,"_132":61,"_43":133,"_134":135,"_136":114,"_137":129,"_138":70,"_139":22},"content_type","creator",30002480,"digest","sha256:205576ac5ec86be37bec11a4330f61dd1afce0e44015b6ebeaf3fcff6ea46a35","full_size",234387242,"id",1371375215,"images",[107,123],{"_108":109,"_99":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":112,"_120":-5,"_121":102,"_67":70,"_122":-5},"architecture","amd64","sha256:333a550cb4d1c9d30ec8d0b79524af7b7235988cdcb038e290b2d61f1cfc3600","features","","last_pulled","2026-11-04T15:23:13.637862957Z","last_pushed","2026-11-04T13:13:16.990573557Z","os","linux","os_features","os_version","size","variant",{"_108":124,"_99":125,"_111":112,"_113":126,"_115":127,"_117":118,"_119":112,"_120":-5,"_121":128,"_67":70,"_122":-5},"arm64","sha256:7135a6e5a9fde6e59f78b076c5e017d41b3b9d5b57fa81d07a54bc4910f6cfef","2026-11-04T13:49:47.001627538Z","2026-11-04T13:13:17.610177821Z",224623905,"2026-11-04T13:13:19.427689Z","last_updater","last_updater_username","media_type","dev","repository",33092027,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":154,"_162":163,"_148":173,"_174":11},{"_40":155,"_47":157,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":158,"_43":35,"_32":33,"_62":63,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":66,"_73":74,"_75":11,"_76":33,"_77":159,"_83":11,"_84":161,"_89":33,"_90":91},[156],{"_43":44,"_45":46},[49],[61],{"_79":11,"_80":160},[82],{"_86":22,"_87":11,"_88":11},"tags",{"_164":68,"_165":-5,"_166":-5,"_167":168},"count","next","previous","results",[169],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":170,"_55":129,"_130":98,"_131":33,"_132":61,"_43":133,"_134":135,"_136":114,"_137":129,"_138":70,"_139":22},[171,172],{"_108":109,"_99":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":112,"_120":-5,"_121":102,"_67":70,"_122":-5},{"_108":124,"_99":125,"_111":112,"_113":126,"_115":127,"_117":118,"_119":112,"_120":-5,"_121":128,"_67":70,"_122":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
333a550cb4d1	linux/amd64	223.53 MB
7135a6e5a9fd	linux/arm64	214.22 MB

jcpd/dknr-zigbee

Tags for jcpd/dknr-zigbee