Node-RED vs Home Assistant: Die richtige Automation-Plattform für dein Smart Home finden
🔄 Zuletzt aktualisiert: 7. Oktober 2026
KI-generiert: Dieser Artikel und seine Abbildungen wurden von einem KI-System erstellt. Mehr dazu
Node-RED mit Home Assistant verbinden ist in wenigen Minuten erledigt: Node-RED Add-on installieren, den Server-Node mit Home Assistant koppeln und den ersten Flow bauen. Diese Anleitung zeigt dir die Schritte, erklärt, wann Node-RED neben den Home-Assistant-Automationen sinnvoll ist, und enthält einen importierbaren Beispiel-Flow.
Stand: 2026. Beschrieben ist Home Assistant OS mit dem Node-RED Add-on der Home Assistant Community Add-ons und der Integration node-red-contrib-home-assistant-websocket. Menünamen können je nach Version leicht abweichen. Inzwischen heißt es „Dashboards“ statt Lovelace und „Backups“ statt Snapshots.
Wann Node-RED, wann Home Assistant?
Home Assistant und Node-RED schließen sich nicht aus. Home Assistant bindet deine Geräte ein und verwaltet sie. Node-RED ist ein visueller Flow-Editor, der über die WebSocket-API von Home Assistant liest und schaltet. Für einfache Wenn-Dann-Regeln reichen die Home-Assistant-Automationen. Node-RED lohnt sich, wenn die Logik umfangreich wird oder du externe Dienste und Daten verarbeiten willst.
| Situation | Empfehlung |
|---|---|
| Einfache Regeln (Licht bei Bewegung, Sonnenuntergang, Benachrichtigung) | Home-Assistant-Automation |
| Viele Bedingungen, Zwischenspeicher, Zeitfenster, Verzweigungen | Node-RED zusätzlich |
| HTTP-APIs, MQTT-Daten oder Strompreise aufbereiten | Node-RED zusätzlich |
| Du willst Abläufe live im Diagramm verfolgen | Node-RED |
| Du willst möglichst wenig Software und arbeitest gern mit YAML und Git | Nur Home Assistant |
| Geräte einbinden (Zigbee, Hue, Matter, WLAN) | Immer zuerst Home Assistant |

Entscheidungsbaum zur Wahl zwischen Home-Assistant-Automationen, Node-RED oder beidem
Was ist Node-RED, was ist Home Assistant?
Home Assistant
Home Assistant ist die zentrale Smart-Home-Plattform. Sie bindet Geräte über Integrationen ein, speichert deren Zustände und bietet Dashboards, Apps, Automationen, Szenen und Skripte. Die Zahl der Integrationen liegt bei über tausend.
Node-RED
Node-RED ist ein ereignisbasiertes Programmierwerkzeug im Browser. Du ziehst Bausteine (Nodes) auf eine Fläche und verbindest sie zu Flows. Es ist keine Smart-Home-Zentrale und kennt deine Geräte nicht selbst. Dafür gibt es Nodes für HTTP, MQTT, Zeitsteuerung, Dateien und viele Dienste. Über die Home-Assistant-Nodes greifst du auf Entitäten und Aktionen zu.
Wie sie zusammenarbeiten
Home Assistant bleibt die Geräteschicht und die Quelle der Wahrheit für Zustände. Node-RED hört auf Zustandsänderungen, entscheidet nach deiner Logik und ruft Aktionen in Home Assistant auf.

Architektur: Geräte → Home Assistant ⇄ Node-RED (WebSocket-API)
Node-RED vs. Home-Assistant-Automationen im Vergleich
| Kriterium | Home-Assistant-Automationen | Node-RED |
|---|---|---|
| Bedienung | Automation-Editor (UI) und YAML | Flow-Editor mit Drag & Drop |
| Lernkurve | Einfache Regeln sehr schnell, Templates (Jinja) erfordern Einarbeitung | Flow-Konzept und Message-Objekt (msg) müssen erst verstanden werden, danach flexibel |
| Debugging | Abläufe/Traces je Automation, Entwicklerwerkzeuge | Debug-Seitenleiste, Node-Status, Nachrichten live verfolgbar |
| Versionierung | YAML-Dateien, leicht per Git zu sichern | flows.json, Git über die Projects-Funktion oder Dateikopie |
| Geräte-Integration | Kernaufgabe: Integrationen für Geräte und Dienste | Keine Geräteverwaltung, Zugriff über Home Assistant oder Protokoll-Nodes (MQTT, HTTP) |
| Dashboards | Home-Assistant-Dashboards (früher Lovelace) | Optional über ein Dashboard-Paket, etwa das FlowFuse Dashboard; das klassische node-red-dashboard gilt als abgelöst |
| Ressourcen | Läuft im Home-Assistant-Prozess | Zusätzlicher Node.js-Prozess mit eigenem Speicherbedarf |
| Wartung | Updates mit Release Notes und gelegentlichen Breaking Changes | Zusätzlich Add-on und Node-Pakete aktuell halten |
Die Oberflächen im Vergleich
Der Automation-Editor von Home Assistant ist formularbasiert: Auslöser, Bedingungen, Aktionen. Das ist übersichtlich, solange die Regel linear bleibt. Der Flow-Editor von Node-RED zeigt dieselbe Logik als Diagramm. Verzweigungen, Wiederholungen und Datenumwandlung sind dort leichter zu überblicken, bei sehr großen Flows aber auch leichter zu überladen.
Und die Performance?
Pauschale Geschwindigkeitsaussagen sind nicht seriös. Für Heimautomation liegen beide Systeme bei normalen Regeln im Bereich weniger Millisekunden bis Bruchteile von Sekunden. Entscheidend sind Hardware, Anzahl der Entitäten und die Logik selbst. Node-RED läuft als eigener Prozess und braucht zusätzlichen Arbeitsspeicher.
Die folgende Tabelle zeigt Messwerte aus einem einzelnen Heim-Setup (identische Hardware: Intel NUC i5, 8 GB RAM). Es gab keine standardisierte Messmethode. Verstehe sie als grobe Orientierung, nicht als Benchmark.
| Metrik | Home Assistant | Node-RED | Differenz |
|---|---|---|---|
| CPU-Usage (Idle) | 12-15% | 8-11% | -4% |
| RAM-Verbrauch | 847MB | 234MB | -613MB |
| Startup-Zeit | 47s | 12s | -35s |
| Response-Zeit (10 Geräte) | 340ms | 180ms | -160ms |
| Response-Zeit (50 Geräte) | 1.2s | 450ms | -750ms |
Häufige Missverständnisse
- „Man muss sich entscheiden.“ Nein. Der Parallelbetrieb ist der Normalfall. Wichtig ist, dass pro Gerät und Aufgabe genau ein System zuständig ist (siehe Probleme).
- „Home Assistant ist für Anfänger, Node-RED für Profis.“ Beides stimmt so nicht. Einfache Node-RED-Flows sind schnell gebaut, und Home Assistant kann mit Templates sehr komplex werden.
- „Node-RED hat die bessere Geräteunterstützung.“ Node-RED hat keine Geräteverwaltung. Funkgeräte (Zigbee/Z-Wave) und Bridges bindest du in Home Assistant ein. Node-RED nutzt sie anschließend über die Home-Assistant-Nodes.
- „Flows lassen sich nicht versionieren.“ Doch: Flows sind JSON-Dateien. Mit der Projects-Funktion oder einer Dateikopie sind sie git-tauglich.
Node-RED installieren
Add-on in Home Assistant OS (empfohlen)
Das ist der einfachste Weg. Home Assistant verwaltet Updates, Backups und die Verbindung für dich.
- Öffne Einstellungen → Add-ons → Add-on-Store.
- Suche nach Node-RED. Erscheint es nicht, füge über das Menü (⋮) → Repositories das Repository
https://github.com/hassio-addons/repositoryhinzu und lade den Store neu. - Klicke auf Installieren.
- Öffne die Registerkarte Konfiguration und setze ein
credential_secret. Damit verschlüsselt Node-RED gespeicherte Zugangsdaten. Optional kannst du SSL einschalten. - Starte das Add-on. Aktiviere „In Seitenleiste anzeigen“ und „Beim Hochfahren starten“. Dann öffnest du den Editor über die Seitenleiste.
Das Add-on bringt die Home-Assistant-Nodes bereits mit. Du musst sie nicht über die Palette nachinstallieren.
Welche Installationsart brauche ich?
Das Add-on gibt es nur mit Add-on-Store, also bei Home Assistant OS und Supervised. Bei Home Assistant Container und Core installierst du Node-RED selbst. Das Supervised-Setup ist an bestimmte Debian-Voraussetzungen gebunden, für Einsteiger ist Home Assistant OS die bessere Wahl.
| Aspekt | HA Core + Node-RED | HA Supervised + Node-RED | HA Container + Node-RED Container |
|---|---|---|---|
| Installation | Manuell, Python venv | Debian-Package + Add-on | Docker Compose |
| Updates | pip upgrade | Supervisor-UI | Container-Images |
| Add-ons | ❌ Keine | ✅ Vollständig | ❌ Separate Container |
| Hardware-Zugriff | ✅ Direkt | ✅ Über Supervisor | ⚠️ Device-Mapping nötig |
| Ressourcen | Niedrig (500MB RAM) | Mittel (1GB RAM) | Niedrig (600MB RAM) |
| Backup | Manuell | Supervisor-Snapshots | Volume-Backups |
| Aspekt | Core | Supervised | OS |
|---|---|---|---|
| Update-Mechanismus | pip install --upgrade homeassistant |
Supervisor UI + ha core update |
Automatisch über UI |
| Add-on-Verfügbarkeit | Keine | Vollständig | Vollständig |
| Systemd-Integration | Manuell mit systemctl --user |
Supervisor verwaltet Services | Vollständig integriert |
| Backup-Methoden | Manuelle config-Kopie + rsync |
ha backups new --name "manual" |
UI + ha backups |
| Migration Core→Supervised | Config kopieren + Supervisor installieren | – | Nicht direkt möglich |
| Migration Supervised→OS | Backup erstellen → OS flashen → Restore | Backup über UI → OS-Installation | – |
| Python-Environment | System-Python oder venv | Container-isoliert | Container-isoliert |
| Abhängigkeiten-Management | pip + requirements.txt | Supervisor + Docker | Vollständig verwaltet |
Node-RED separat auf dem Raspberry Pi
Für Container- und Core-Installationen bietet das Node-RED-Projekt ein Installationsskript für Raspberry Pi OS und Debian. Prüfe das Skript vor dem Ausführen in der offiziellen Anleitung:
bash <(curl -sL https://raw.githubusercontent.com/node-red/linux-installers/master/deb/update-nodejs-and-nodered)
sudo systemctl enable nodered.service
sudo systemctl start nodered.service
Der Editor ist danach unter http://IP-DES-GERÄTS:1880 erreichbar. Die Home-Assistant-Nodes installierst du in diesem Fall über Menü → Palette verwalten → Installieren (node-red-contrib-home-assistant-websocket).
Node-RED per Docker Compose
Läuft Home Assistant als Container, bekommt Node-RED einen eigenen Container. Beispiel (eine version:-Zeile ist bei aktuellem Docker Compose nicht mehr nötig):
services:
homeassistant:
container_name: homeassistant
image: ghcr.io/home-assistant/home-assistant:stable
network_mode: host
volumes:
- ./ha-config:/config
- /etc/localtime:/etc/localtime:ro
environment:
- TZ=Europe/Berlin
restart: unless-stopped
nodered:
container_name: nodered
image: nodered/node-red:latest
ports:
- "1880:1880"
volumes:
- ./nodered-data:/data
environment:
- TZ=Europe/Berlin
restart: unless-stopped
Starten mit docker compose up -d. Zwei Stolpersteine: Ohne TZ rechnen Zeit- und Sonnenstands-Auslöser falsch. Und localhost zeigt im Node-RED-Container auf den Container selbst. Trage als Home-Assistant-Adresse die IP des Hosts ein, zum Beispiel http://192.168.1.50:8123. Für USB-Sticks brauchst du in Home Assistant zusätzlich eine devices:-Zuordnung.
Auf NAS-Systemen gilt dasselbe Prinzip: Auf Synology NAS läuft Home Assistant als Container, Node-RED bekommt einen eigenen. Bei Synology-Geräten liegen die Datenpfade typischerweise unter /volume1/docker/…. Prüfe bei Synology DSM 7 im Container Manager, dass die Volumes auf /config und /data zeigen, sonst gehen Einstellungen beim Neustart verloren. Bei QNAP mit der Container Station funktioniert es genauso, wenn Volumes und Zeitzone sauber gesetzt sind.
Welche Hardware reicht?
Für kleine bis mittlere Setups genügt ein Raspberry Pi 4 mit SSD statt SD-Karte. Home Assistant schreibt dauerhaft in die Datenbank. SD-Karten sind bei Dauerbetrieb Verschleißteile, deshalb ist eine SSD die robustere Wahl. Wer viele Entitäten oder zusätzliche Dienste betreibt, ist mit einem Mini-PC wie Intel NUC besser bedient. Beobachte dort die Temperatur, denn Leistungseinbrüche unter Dauerlast kommen vor:
| Temperatur | CPU-Frequenz | Node-RED Response | Throttling |
|---|---|---|---|
| 45-65°C | 2400 MHz | 180ms | Nein |
| 66-80°C | 2000 MHz | 240ms | Leicht |
| 81-95°C | 1600 MHz | 380ms | Moderat |
| 96-100°C | 1200 MHz | 650ms | Stark |
Node-RED mit Home Assistant verbinden
Variante A: Add-on mit Supervisor-Verbindung (ohne Token)
- Öffne den Node-RED-Editor und ziehe einen Home-Assistant-Node, zum Beispiel events: state, auf die Fläche.
- Doppelklick auf den Node → beim Feld Server auf den Stift klicken, um eine neue Server-Konfiguration anzulegen.
- Aktiviere die Option für das Home Assistant Add-on („Home Assistant Add-on“ bzw. „Use Home Assistant Add-on“, je nach Version). Node-RED nutzt dann den internen Supervisor-Zugang, den das Add-on bereitstellt, und braucht keinen Token. Der interne Zugang ist über
http://supervisor/coreerreichbar. - Klicke auf Hinzufügen und dann auf Deploy. Unter dem Node erscheint der Status „connected“. Im Feld Entity kannst du danach Entitäten per Auswahl finden.
Variante B: Long-Lived Access Token (externes Node-RED)
- In Home Assistant: unten links auf dein Profil → Reiter Sicherheit → Langlebige Zugriffstoken → Token erstellen. Kopiere den Token sofort, er wird nur einmal angezeigt.
- In Node-RED: Server-Konfiguration anlegen, Base URL eintragen (zum Beispiel
http://192.168.1.50:8123) und den Token einfügen. - Deploy. Der Status wechselt auf „connected“.
Nutze nach Möglichkeit die interne Adresse. Läuft die Verbindung über einen Reverse-Proxy, müssen WebSocket-Header weitergereicht werden. In Home Assistant muss der Proxy zusätzlich unter http: mit use_x_forwarded_for und trusted_proxies freigegeben sein.
Companion-Integration hass-node-red (HACS)
Mit der Integration hass-node-red (Installation über HACS) bekommt Home Assistant eine Gegenstelle zu Node-RED:
- In Node-RED erzeugst du Entitäten (Sensor, Binärsensor, Schalter, Button), die in Home Assistant erscheinen und dort in Dashboards und Automationen nutzbar sind.
- Du kannst Flows über einen Schalter in Home Assistant aktivieren oder deaktivieren.
- Es gibt zusätzliche Nodes für Webhooks und Geräte-Auslöser.
Einrichtung: Integration über HACS installieren, Home Assistant neu starten, dann Einstellungen → Geräte & Dienste → Integration hinzufügen und die Node-RED-Integration auswählen. Sie braucht die Home-Assistant-Nodes in Node-RED.
Ergänzung: MQTT
Die Home-Assistant-Nodes sind für Aufgaben rund um Home Assistant der direkteste Weg. MQTT nutzt du, wenn Daten aus anderen Quellen kommen, zum Beispiel von ESP-Geräten oder Zigbee2MQTT. Voraussetzung ist ein Broker (etwa das Mosquitto-Add-on) und die MQTT-Integration in Home Assistant. In Node-RED verwendest du die eingebauten Nodes mqtt in und mqtt out.
Einen Sensor kannst du per MQTT Discovery anlegen. Sende dazu diese Nachricht mit gesetztem „Retain“ an homeassistant/sensor/nodered_test/config:
{
"name": "Node-RED Testsensor",
"unique_id": "nodered_test_temp",
"state_topic": "nodered/test/temperature",
"unit_of_measurement": "°C",
"device_class": "temperature"
}
Danach veröffentlichst du Werte wie 22.5 auf nodered/test/temperature. Der Sensor erscheint automatisch in Home Assistant.
Die wichtigsten Nodes und dein erster Flow
Die wichtigsten Home-Assistant-Nodes
| Node | Zweck | Typischer Einsatz |
|---|---|---|
| events: state | Meldet Zustandsänderungen einer Entität | Auslöser: Bewegungsmelder, Tür, Schalter |
| trigger: state | Auslöser mit Bedingungen, Verzögerung und Gegen-Ausgang | „Sensor länger als 5 Minuten offen“ |
| current state | Fragt den aktuellen Zustand ab | Bedingung mitten im Flow: „Ist jemand zu Hause?“ |
| call service (je nach Version „action“) | Ruft eine Home-Assistant-Aktion auf | light.turn_on, notify.mobile_app_… |
| poll state | Liest einen Zustand in festen Abständen | Sensoren, die selten Ereignisse senden |
| wait until | Wartet, bis ein Zustand eintritt | „Warte, bis Fenster geschlossen“ |
| get entities | Liefert eine gefilterte Entitätenliste | Alle Lichter oder Fenster auswerten |
| render template | Wertet ein Home-Assistant-Template aus | Texte und Berechnungen auf Basis von Zuständen |
| webhook | Empfängt Aufrufe von außen | Anbindung externer Dienste |
Dazu kommen die Standard-Nodes von Node-RED: switch (verzweigen), change (Nachrichten umformen), function (JavaScript), delay und trigger (Zeitsteuerung) sowie debug (Ausgabe in der Seitenleiste).
Erster Flow: Bewegungslicht mit Nachlaufzeit
Ziel: Das Licht im Flur geht bei Bewegung an und fünf Minuten nach der letzten Bewegung wieder aus. Jede neue Bewegung verlängert die Zeit. Das Verhalten stammt vom Standard-Node trigger mit „extend“.
- Menü (☰) → Import → JSON einfügen → Import.
- Öffne den Node Bewegung Flur an und wähle deinen Server. Die Entität
binary_sensor.flur_bewegungersetzt du durch deinen Bewegungsmelder. - Passe in den Nodes Licht an und Licht aus die Entität
light.fluran. - Klicke auf Deploy und löse den Melder aus.
[
{"id":"flow1","type":"tab","label":"Bewegungslicht Flur","disabled":false,"info":""},
{"id":"ha_server","type":"server","name":"Home Assistant","version":5,"addon":true,"rejectUnauthorizedCerts":true,"ha_boolean":"y|yes|true|on|home|open","connectionDelay":true,"cacheJson":true,"heartbeat":false,"heartbeatInterval":30,"areaSelector":"friendlyName","deviceSelector":"friendlyName","entitySelector":"friendlyName","statusSeparator":"at: ","statusYear":"hidden","statusMonth":"short","statusDay":"numeric","statusHourCycle":"h23","statusTimeFormat":"h:m","enableGlobalContextStore":true},
{"id":"n_motion","type":"server-state-changed","z":"flow1","name":"Bewegung Flur an","server":"ha_server","version":5,"outputs":2,"exposeAsEntityConfig":"","entityId":"binary_sensor.flur_bewegung","entityIdType":"exact","outputInitially":false,"stateType":"str","ifState":"on","ifStateType":"str","ifStateOperator":"is","outputOnlyOnStateChange":true,"for":"0","forType":"num","forUnits":"minutes","ignorePrevStateNull":false,"ignorePrevStateUnknown":false,"ignorePrevStateUnavailable":false,"ignoreCurrentStateUnknown":false,"ignoreCurrentStateUnavailable":false,"outputProperties":[{"property":"payload","propertyType":"msg","value":"","valueType":"entityState"},{"property":"data","propertyType":"msg","value":"","valueType":"eventData"},{"property":"topic","propertyType":"msg","value":"","valueType":"triggerId"}],"x":150,"y":100,"wires":[["n_trigger"],[]]},
{"id":"n_trigger","type":"trigger","z":"flow1","name":"5 Min. nachlaufen","op1":"1","op2":"0","op1type":"str","op2type":"str","duration":"5","extend":true,"overrideDelay":false,"units":"min","reset":"","bytopic":"all","topic":"topic","outputs":1,"x":370,"y":100,"wires":[["n_switch"]]},
{"id":"n_switch","type":"switch","z":"flow1","name":"an oder aus?","property":"payload","propertyType":"msg","rules":[{"t":"eq","v":"1","vt":"str"},{"t":"eq","v":"0","vt":"str"}],"checkall":"true","repair":false,"outputs":2,"x":570,"y":100,"wires":[["n_on"],["n_off"]]},
{"id":"n_on","type":"api-call-service","z":"flow1","name":"Licht an","server":"ha_server","version":5,"debugenabled":false,"domain":"light","service":"turn_on","areaId":[],"deviceId":[],"entityId":["light.flur"],"data":"{\"brightness_pct\":80}","dataType":"json","mergeContext":"","mustacheAltTags":false,"outputProperties":[],"queue":"none","x":770,"y":80,"wires":[[]]},
{"id":"n_off","type":"api-call-service","z":"flow1","name":"Licht aus","server":"ha_server","version":5,"debugenabled":false,"domain":"light","service":"turn_off","areaId":[],"deviceId":[],"entityId":["light.flur"],"data":"","dataType":"json","mergeContext":"","mustacheAltTags":false,"outputProperties":[],"queue":"none","x":770,"y":120,"wires":[[]]}
]
Erwartetes Ergebnis: Bei Bewegung geht das Licht auf 80 % an. Fünf Minuten nach der letzten Bewegung geht es aus. Die Felder der Home-Assistant-Nodes ändern sich zwischen Versionen. Prüfe daher nach dem Import die Server- und Entitätsauswahl in beiden Aktions-Nodes und bestätige sie einmal neu. Nutzt du Node-RED ohne Add-on, trage in der Server-Konfiguration URL und Token ein. Hänge zur Kontrolle einen debug-Node an den Ausgang von Bewegung Flur an.
Praxisbeispiel: Verbraucher bei günstigem Strompreis schalten
Mit dynamischem Stromtarif willst du zum Beispiel Wallbox, Boiler oder Waschmaschine in günstigen Phasen einschalten. Home Assistant bietet Integrationen für gängige Preisquellen (etwa Tibber, aWATTar oder Nord Pool). Die Preise liegen dann als Sensor vor. Der Flow selbst besteht aus wenigen Nodes:
- events: state auf dem Preissensor, ohne Bedingung. Er feuert bei jeder Preisänderung.
- switch mit zwei Regeln:
msg.payloadkleiner als dein Schwellwert (zum Beispiel 0,25) und größer oder gleich dem Schwellwert. Der Preis kommt als Text an. Stelle den Vergleich auf „numerisch“ oder wandle ihn vorher mit einem change-Node um. - current state auf einem Zeit- oder Anwesenheitsfilter. Beispiel: Die Wallbox startet nur, wenn das Auto angeschlossen ist.
- call service mit
switch.turn_onbei günstigem Preis undswitch.turn_offbei teurem Preis.
Tipps: Verwende eine Hysterese, also einen Ein- und einen etwas höheren Aus-Schwellwert, damit nichts ständig schaltet. Lege Schwellwerte als Helfer (input_number) in Home Assistant an und lies sie per current state aus. Dann kannst du sie im Dashboard ändern, ohne den Flow anzufassen. Die Steuerung langer Geräte-Laufzeiten, etwa einer Waschmaschine, braucht zusätzlich eine eigene Logik. Du solltest sie nur mit Geräten umsetzen, die sich per Aktion sicher starten und stoppen lassen. Genau solche Aufgaben mit Datenaufbereitung, Schwellen und mehreren Bedingungen sind der typische Fall, in dem Node-RED übersichtlicher bleibt als eine verschachtelte YAML-Automation.
Node-RED-Flows in Home-Assistant-Automationen umwandeln
Nicht jeder Flow muss in Node-RED bleiben. Einfache Abläufe lassen sich als Home-Assistant-Automation nachbauen. Das spart Ressourcen und Wartung. Eine Zuordnung der Bausteine:
| Node-RED | Home Assistant |
|---|---|
| events: state / trigger: state | Auslöser trigger: state (optional mit for:) |
| inject mit Zeitplan | Auslöser trigger: time oder time_pattern |
| current state + switch | Bedingungen (state, numeric_state, template) |
| Verzweigung per switch | choose oder if/then/else |
| call service / action | action: |
| delay | delay: oder wait_for_trigger |
| trigger-Node mit „extend“ | mode: restart |
| function mit Berechnung | Template-Sensor oder Template-Bedingung |
Der Bewegungslicht-Flow von oben als Automation (Syntax ab Home Assistant 2024.10, davor hießen die Schlüssel trigger/platform und service):
alias: Bewegungslicht Flur
mode: restart
triggers:
- trigger: state
entity_id: binary_sensor.flur_bewegung
to: "on"
actions:
- action: light.turn_on
target:
entity_id: light.flur
data:
brightness_pct: 80
- delay: "00:05:00"
- action: light.turn_off
target:
entity_id: light.flur
Mit mode: restart startet jede neue Bewegung die Automation neu und verlängert so die Nachlaufzeit. Das entspricht dem „extend“ des trigger-Nodes. Prüfe umgewandelte Automationen im Bereich Abläufe (Trace) der Automation. Besser in Node-RED aufgehoben bleiben Flows mit externen APIs, Datenumformung oder vielen Zwischenzuständen. Teste die neue Automation, bevor du den alten Flow deaktivierst, und lass nie beide gleichzeitig dasselbe Gerät schalten.
Häufige Probleme, Backup und Best Practices
Probleme und Lösungen
| Symptom | Ursache | Lösung |
|---|---|---|
| Add-on erscheint nicht oder lässt sich nicht installieren | Repository fehlt, Netzwerk- oder DNS-Problem, zu wenig Speicher | Repository hinzufügen, Store neu laden, Supervisor-Protokoll prüfen (ha supervisor logs), bei DNS-Problemen ha dns restart |
| Server-Node zeigt „Invalid authentication“ oder bleibt „connecting“ | Token falsch, gelöscht oder gekürzt kopiert; falsche Adresse | Neuen Token erstellen, Adresse prüfen (http://, Port 8123), Home Assistant einmal neu starten |
| Verbindung bricht nach Home-Assistant-Neustart ab | Home Assistant ist beim Start von Node-RED noch nicht bereit | Nodes verbinden sich meist selbst neu. Die Server-Option „Connection delay“ kann beim Start helfen. |
| Entitäten fehlen in der Auswahl | Server nicht verbunden oder Editor-Cache | Server-Status prüfen, Editor neu laden, Flow deployen |
| Node-RED im Container erreicht Home Assistant nicht | localhost zeigt auf den eigenen Container |
Host-IP verwenden, oder im selben Compose-Netz den Dienstnamen nutzen (nicht bei network_mode: host) |
| Zeit- und Sonnenstands-Auslöser falsch | Zeitzone im Container fehlt | TZ=Europe/Berlin setzen |
| Lichter schalten „von selbst“ ein und aus | Zwei Systeme steuern dasselbe Gerät | Zuständigkeit klar trennen (siehe unten) |
| Nodes sind nach einem Update rot oder veraltet | Neue Home-Assistant- oder Node-Version | Paletten-Update installieren, Release Notes lesen |
Typische Fälle im Überblick:
| Problem | Diagnose | Bestätigung | Ursache | Lösung |
|---|---|---|---|---|
| Unklarheit über eigene Smart Home Ziele und Geräte-Landschaft führt zu Verwirrung bei Plattform-Auswahl | find /home -name '*.yaml' -o -name '*.json' -o -name 'devices.txt' | head -10 && echo '--- Geräte-Inventar:' && ls -la /etc/homeassistant/ 2>/dev/null || echo 'Keine HA-Config gefunden' |
Keine strukturierte Konfiguration oder Geräte-Dokumentation vorhanden, leere oder fehlende Verzeichnisse | Fehlende Anforderungsanalyse | mkdir -p ~/smart-home-docs && echo '# Smart Home Anforderungenn## Geräte:n- n## Ziele:n- n## Protokolle:n- ' > ~/smart-home-docs/requirements.md && echo 'Dokumentation erstellt in ~/smart-home-docs/requirements.md - jetzt ausfüllen!' |
| Unsicherheit ob vorhandene Smart Home Geräte mit gewählter Plattform funktionieren | nmap -sn 192.168.1.0/24 | grep -E '(Nmap scan|Host is up)' && echo '--- Zigbee/Z-Wave Check:' && lsusb | grep -iE '(zigbee|z-wave|conbee|aeotec)' |
Viele unbekannte IP-Geräte im Netzwerk gefunden, aber keine USB-Dongles für Zigbee/Z-Wave erkannt | Unbekannte Geräte-Kompatibilität | nmap -sn 192.168.1.0/24 | grep 'Nmap scan' | awk '{print $5}' > ~/device-inventory.txt && echo 'Geräte-IPs gespeichert. Jetzt manuell identifizieren und Kompatibilität prüfen auf: https://www.home-assistant.io/integrations/' |
| Beide Systeme laufen parallel und kämpfen um dieselben Geräte-Ressourcen oder Ports | docker ps --format 'table {{.Names}}\t{{.Ports}}' | grep -E '(homeassistant|nodered)' && netstat -tulpn | grep -E ':(1880|8123)' | head -5 |
Sowohl Home Assistant (Port 8123) als auch Node-RED (Port 1880) laufen gleichzeitig, möglicherweise Port-Konflikte sichtbar | Parallelbetrieb-Konflikt | docker stop $(docker ps -q --filter 'name=nodered') && echo 'Node-RED gestoppt. Entscheide: HA als Zentrale + Node-RED als Automations-Engine ODER nur eine Plattform nutzen' |
| System wird langsam oder instabil wenn komplexe Automationen mit vielen Geräten ausgeführt werden | free -h && echo '--- CPU Load:' && uptime && echo '--- Docker Memory:' && docker stats --no-stream --format 'table {{.Name}}t{{.CPUPerc}}t{{.MemUsage}}' |
Weniger als 1GB freier RAM, Load Average > 2.0, Docker Container nutzen >80% der verfügbaren Ressourcen | Unzureichende Hardware-Ressourcen | docker update --memory=512m --cpus=1.0 homeassistant && docker update --memory=256m --cpus=0.5 nodered && echo 'Container-Limits gesetzt. Bei weiterhin schlechter Performance: Hardware upgraden (min. 4GB RAM)' |
| Unklarheit wie Node-RED und Home Assistant zusammenarbeiten können statt sich zu ersetzen | curl -s http://localhost:8123/api/ 2>/dev/null | head -1 && echo '--- Node-RED HA Nodes:' && find /data -name '*home*assistant*' 2>/dev/null || echo 'Keine HA-Integration in Node-RED gefunden' |
Home Assistant API erreichbar, aber keine Home Assistant Nodes oder Integration in Node-RED konfiguriert | Fehlende Integration-Kenntnisse | docker exec -it nodered npm install node-red-contrib-home-assistant-websocket && echo 'HA-Nodes installiert. Node-RED neustarten und HA-Server konfigurieren: http://localhost:8123 mit Long-Lived Access Token' |
| Überschätzung der eigenen technischen Fähigkeiten führt zu Frustration bei der Implementierung | find /home -name '*.js' -o -name '*.py' -o -name '*.yaml' | wc -l && echo '--- Git Repos:' && find /home -name '.git' -type d | wc -l |
Weniger als 10 Konfigurationsdateien gefunden, keine Git-Repositories für Versionskontrolle vorhanden | Komplexitäts-Fehleinschätzung | cd ~ && git init smart-home-backup && cp -r /config/* smart-home-backup/ 2>/dev/null && echo 'Backup-Repo erstellt. TIPP: Starte mit 1-2 Geräten, dann schrittweise erweitern. Nutze HA Community Forum für Hilfe.' |
Parallelbetrieb ohne Konflikte
Die meisten Konflikte entstehen, wenn Home Assistant und Node-RED dasselbe Gerät steuern. Ein Beispiel sind Bridge-Lampen (Philips Hue), bei denen eine Automation einschaltet und ein Flow ausschaltet. Lege deshalb für jede Aufgabe ein System fest. Ein gutes Muster: Einfache Szenen und Zeitpläne bleiben in Home Assistant, Datenlogik und komplexe Abläufe liegen in Node-RED. Zusätzlich hilft es, Funkgeräte nur einmal einzubinden: Zigbee-Geräte oder eine Philips Hue Bridge werden einmal in Home Assistant eingerichtet und stehen dann beiden Seiten zur Verfügung. Mehr als ein Weg zum selben Gerät ist keine Redundanz, sondern eine Fehlerquelle.
Backup und Versionierung
- Home-Assistant-Backups: Unter Einstellungen → System → Backups sicherst du Home Assistant samt Add-ons. Das Node-RED Add-on mit seinen Flows kannst du in das Backup aufnehmen. Kopiere Backups regelmäßig auf einen anderen Speicher, zum Beispiel ein NAS oder einen Cloud-Speicher.
- Flows einzeln sichern: Im Editor über Menü → Export. Die Flows liegen in
flows.json. Beim Add-on findest du sie im Add-on-Konfigurationsordner (/addon_configs/a0d7b954_nodered/). - Zugangsdaten: Passwörter und Tokens stehen verschlüsselt in
flows_cred.json. Der Schlüssel ist dascredential_secretaus der Add-on-Konfiguration. Notiere es dir. Ohne den passenden Schlüssel lassen sich die Zugangsdaten nach einem Restore nicht mehr entschlüsseln. - Git: Die Projects-Funktion von Node-RED (in den Editor-Einstellungen aktivierbar) bringt Git-Anbindung mit. Alternativ legst du
flows.jsonin ein eigenes Repository. Veröffentliche dabei nieflows_cred.jsonoder Tokens. - Restore: Add-on stoppen, Dateien zurückkopieren, Add-on starten. Oder ein Home-Assistant-Backup wiederherstellen.
Best Practices für Flows
- Nutze pro Themenbereich einen eigenen Tab (Licht, Heizung, Energie).
- Benenne Nodes sprechend und ergänze Kommentar-Nodes für Entscheidungen.
- Wiederkehrende Teile gehören in Subflows.
- Fange Fehler mit einem catch-Node ab und zeige bei Bedarf eine Benachrichtigung.
- Halte Flows klein. Mehr als etwa 20 Nodes auf einem Tab sind ein Hinweis, aufzuteilen.
- Gib deinen Home-Assistant-Token nie in Flows oder Screenshots preis.
- Lies bei Updates die Release Notes von Home Assistant und der Home-Assistant-Nodes.
Häufige Fragen (FAQ)
Brauche ich Node-RED zusätzlich zu Home Assistant?
Nicht unbedingt. Für einfache Wenn-Dann-Regeln genügen die Home-Assistant-Automationen. Node-RED lohnt sich bei komplexer Logik, externen Datenquellen oder wenn du Abläufe lieber visuell baust.
Welche Version und welches Add-on soll ich nehmen?
Nutze das Node-RED Add-on aus den Home Assistant Community Add-ons und halte es zusammen mit Home Assistant aktuell. Die Home-Assistant-Nodes (node-red-contrib-home-assistant-websocket) sind darin enthalten.
Sind Node-RED-Flows versionierbar?
Ja. Flows liegen als JSON-Datei vor. Du kannst sie über die Projects-Funktion mit Git verwalten oder die Datei in ein Repository legen. Zugangsdaten gehören nicht ins Repository.
Wie betreibe ich beide Systeme ohne Konflikte?
Weise jedem Gerät und jeder Aufgabe genau ein System zu. Binde Geräte nur in Home Assistant ein. Lass Node-RED dort Zustände lesen und Aktionen auslösen, und steuere nie dasselbe Gerät aus zwei Automationen.
Gibt es Performance-Unterschiede?
Bei typischen Heimautomationen sind sie nicht spürbar. Node-RED braucht als zusätzlicher Prozess mehr Arbeitsspeicher. Hardware und Anzahl der Entitäten haben meist größeren Einfluss als die Wahl des Werkzeugs.
Ist Node-RED für Einsteiger geeignet?
Ja, wenn du mit einem kleinen Flow startest. Die ersten Flows gelingen schnell. Für Message-Objekt, Verzweigungen und Fehlerbehandlung solltest du etwas Zeit einplanen.
Fazit: Welche Lösung passt zu dir?
- Einsteiger: Starte mit Home Assistant und seinen Automationen. Füge Node-RED erst hinzu, wenn eine Regel im Automation-Editor unübersichtlich wird.
- Fortgeschrittene: Betreibe beide parallel. Home Assistant verwaltet Geräte, Dashboards und einfache Regeln. Node-RED übernimmt Datenlogik, externe Dienste und größere Abläufe wie das Strompreis-Beispiel.
- Entwickler: Node-RED mit Projects/Git und eigenen Funktions-Nodes bietet viel Spielraum. Die Geräteintegration bleibt trotzdem Aufgabe von Home Assistant.
Nächste Schritte: Add-on installieren, den Server-Node verbinden, den Beispiel-Flow importieren und anpassen. Danach lohnt sich ein Backup mit notiertem credential_secret. Vertiefende Themen rund um das Setup sind MQTT-Anbindung, Backup und Restore, Docker-Compose-Betrieb und Verbindungsprobleme per WebSocket.
Quellen und Methodik
- Home Assistant Dokumentation
- Node-RED Add-on (GitHub)
- node-red-contrib-home-assistant-websocket (GitHub)
- hass-node-red Companion-Integration (GitHub)
- Node-RED Dokumentation
Die Anleitung beschreibt Home Assistant OS mit dem Community-Add-on, Stand 2026. Die einzelnen Messwerte im Performance-Abschnitt stammen aus einem einzelnen Privat-Setup ohne standardisierte Methode und sind keine reproduzierbaren Benchmarks. Der Beispiel-Flow muss nach dem Import an deine Entitäten und die installierte Node-Version angepasst werden.
Passende Hardware für dein Setup
Für Home Assistant mit Node-RED eignen sich zum Beispiel ein Raspberry Pi 4 oder 5, eine NVMe- oder SATA-SSD statt SD-Karte und ein Zigbee-Stick. Die Auswahl:
| Produkt | Fachhandel | Amazon | eBay |
|---|---|---|---|
| Raspberry Pi 4 Model B | — | Amazon | eBay |
| Philips Hue Bridge | cyberport DE | Amazon | eBay |
| Home Assistant | — | – | eBay |
| Node-RED Dashboard | — | Amazon | eBay |
| Home Assistant Lovelace | — | Amazon | eBay |
| Intel NUC | cyberport DE | Amazon | eBay |
| Echo Dot 5 | notebooksbilliger DE/AT | Amazon | eBay |
| Home Assistant Core | — | Amazon | eBay |
Unsere Empfehlungen

* Affiliate-Links – beim Kauf erhalten wir ggf. eine Provision. Preise inkl. MwSt., Stand laut Produktfeed – können abweichen.
| Produkt | Fachhandel | Amazon | eBay |
|---|---|---|---|
| Philips Hue Bridge Tipp | cyberport DE | Amazon | eBay |
| Raspberry Pi 4 Model B | – | Amazon | eBay |
| Sonos Speaker | – | Amazon | eBay |
| Echo Dot 5 | notebooksbilliger DE/AT | Amazon | eBay |
* Affiliate-Links – beim Kauf erhalten wir ggf. eine Provision.






Hinterlasse einen Kommentar
An der Diskussion beteiligen?Hinterlasse uns deinen Kommentar!