Informations clés
Editeur : IBM puis OpenJS Foundation
Message Queuing Telemetry Transport
Type : Outil d’automatisation visuelle (logiciel)

Qu’est-ce que Node-Red ?
Node-RED est un outil de programmation visuelle par flux (flow-based programming) développé initialement par IBM, aujourd’hui open source et maintenu par la OpenJS Foundation. Il permet de créer des automatisations domotiques complexes via une interface graphique drag-and-drop, sans écrire de code traditionnel. Il est particulièrement populaire en combinaison avec Home Assistant, MQTT et Z-Wave.
Concepts fondamentaux
| Concept | Description | Exemple domotique |
| Node | Bloc fonctionnel avec une entrée et/ou sortie | mqtt in, z-wave switch, delay, function |
| Flow | Séquence de nodes connectés entre eux | Capteur Z-Wave → condition → commande |
| Wire | Connexion entre deux nodes | Relie la sortie d’un node à l’entrée du suivant |
| Message (msg) | Objet JSON qui circule entre les nodes | { « payload »: true, « topic »: « zwave/node5 » } |
| Dashboard | Interface web générée par Node-RED | Panel de contrôle de votre domotique |
Intégration avec Z-Wave
Node-RED se connecte à Z-Wave via MQTT ou directement via l’API de Home Assistant / Jeedom. Les nodes disponibles :
- node-red-contrib-z-wave-js : intégration directe avec Z-Wave JS sans passer par MQTT.
- node-red-contrib-mqtt : connexion à Mosquitto pour recevoir/envoyer des trames Z-Wave via MQTT.
- node-red-contrib-home-assistant-websocket : intégration bidirectionnelle complète avec Home Assistant.
💡 Positionnement Node-RED n’est pas un remplacement de Home Assistant ou Jeedom — c’est un complément pour les automatisations que les interfaces natives ne permettent pas facilement. Il excelle pour les flux complexes, les transformations de données et les intégrations entre systèmes hétérogènes.
Installation
Node-RED s’installe comme add-on dans Home Assistant (Node-RED Companion), comme module npm sur un Raspberry Pi, ou via Docker :
# Via npm (méthode recommandée)
npm install -g --unsafe-perm node-red
node-red # Accessible sur http://localhost:1880
Forces et limites
| Forces | Limites |
| Programmation visuelle accessible | Peut devenir difficile à maintenir sur de grands projets |
| Bibliothèque de 4 000+ nodes | Performance limitée pour les flux très intensifs |
| Intégration native MQTT, HTTP, WebSocket | Courbe d’apprentissage pour JavaScript (node Function) |
| Dashboard intégré (node-red-dashboard) | Interface dashboard moins moderne que Grafana |
| Communauté très active | Pas de versioning/backup natif des flows |
Foire aux questions
Non, Node-RED est un complément. Il s’intègre à HA via le plugin node-red-contrib-home-assistant-websocket et ajoute des capacités d’automatisation avancées que l’interface native HA ne propose pas facilement.
Oui, via MQTT. Z-Wave JS UI publie l’état des appareils sur MQTT, et Node-RED s’y connecte avec le node MQTT In/Out. Jeedom peut également envoyer des événements via MQTT vers Node-RED.
L’interface est accessible visuellement. La difficulté vient des nodes ‘Function’ qui utilisent JavaScript. Pour des flows simples sans code, la courbe d’apprentissage est modérée.
