Tutorial: Heizungssteuerung Node Red in wenigen Schritten einrichten

Benötigte Node-RED-Paletten installieren

Für den Thermostat-Flow werden zwei zusätzliche Node-RED-Paletten benötigt. Installiere zuerst node-red-contrib-mytimeout. Diese Palette stellt den Timeout-Baustein für zeitlich begrenzte Aktionen bereit, etwa für den Countdown-Modus.

Danach installierst du node-red-contrib-moment. Sie unterstützt die Zeit- und Datumsverarbeitung im Flow und ist besonders für Wochenpläne, Zeitzonen und zeitgesteuerte Umschaltungen wichtig.

Öffne in Node-RED das Menü.
Wähle Manage palette beziehungsweise Palette verwalten.
Wechsle zum Bereich Install.
Suche nach node-red-contrib-mytimeout und installiere die Palette.
Wiederhole den Vorgang mit node-red-contrib-moment.

Installiere die Paletten möglichst vor dem Import der Flow-Datei. Nach der Installation erscheinen die neuen Nodes in der linken Seitenleiste. Fehlt einer davon, starte Node-RED neu und prüfe, ob die Node-RED-Version und die Palette zusammenpassen. Veraltete Erweiterungen können beim Laden des Flows Warnungen erzeugen.

Den Thermostat-Flow importieren

Wähle vor dem Import die passende Flow-Datei für deine Sprache: flowEN.json für Englisch oder flowIT.json für Italienisch. Eine deutsche Variante ist in diesem Projektstand nicht vorgesehen.

Öffne in Node-RED das Menü und wähle Import. Im Importfenster stehen meist Clipboard, Datei oder Bibliothek zur Verfügung. Nutze Clipboard, wenn du den vollständigen JSON-Inhalt kopiert hast; liegt die Datei lokal vor, wählst du den Datei-Import.

Öffne die gewählte JSON-Datei in einem Texteditor.
Kopiere den kompletten Inhalt, einschließlich der geschweiften Klammern am Anfang und Ende.
Füge den Inhalt in das Clipboard-Feld von Node-RED ein.
Bestätige den Import.
Ordne den neuen Flow einem eigenen Tab zu, falls Node-RED danach fragt.

Nach dem Einfügen erzeugt Node-RED die Tabs, Gruppen und Verbindungen des Thermostat-Dashboards. Prüfe die Darstellung des Flows. Grau markierte oder unbekannte Nodes zeigen meist, dass ein benötigter Baustein fehlt. Öffne in diesem Fall die Node-RED-Protokolle und suche nach der genauen Node-ID.

Importiere den Flow nicht mehrfach in denselben Tab. Sonst entstehen parallele Auslöser, die einen Heizbefehl doppelt an Home Assistant senden können. Falls ein zweiter Import nötig ist, lösche den unvollständigen Versuch zuerst oder verwende einen klar benannten Test-Tab.

Speichere den importierten Stand vor weiteren Änderungen. So kannst du bei einem Fehler schnell zum unveränderten Flow zurückkehren. Die Verbindung zum Heizkörper wird erst über die markierten Konfigurationsknoten hergestellt.

Die passende Sprachversion auswählen

Für dieses Projekt stehen zwei Sprachdateien bereit: flowEN.json für Englisch und flowIT.json für Italienisch. Wähle die Datei, deren Beschriftungen alle Personen im Haushalt sicher verstehen. Die Sprache betrifft vor allem die Oberfläche; Werte, Entity-IDs und Home-Assistant-Dienste ändern sich dadurch nicht.

Englische Oberfläche: flowEN.json
Italienische Oberfläche: flowIT.json

Verwende nicht beide Dateien im selben Dashboard, denn dadurch entstehen doppelte Tabs und uneinheitliche Bezeichnungen. Wenn du später wechseln möchtest, importiere die andere Datei zunächst in einen separaten Test-Tab und entferne die nicht mehr benötigte Variante erst nach dem Vergleich.

Beachte außerdem die Zeitzone deines Home-Assistant-Systems. Die Anzeige von Wochenplan, Countdown und Status richtet sich nach der dort hinterlegten Zeitumgebung. Stimmen Dashboard und lokale Uhr nicht überein, liegt die Ursache meist an einer abweichenden Zeitzonen- oder Sommerzeitkonfiguration.

Home-Assistant-Server und Thermostat-Entity eintragen

Öffne in Home Assistant Einstellungen > Geräte & Dienste > Entitäten und suche nach der Klimasteuerung. Kopiere die vollständige Entity-ID, zum Beispiel climate.termostato. Verwende nicht den Anzeigenamen des Geräts; schon ein vertauschter Buchstabe verhindert die Steuerung.

Öffne danach im importierten Flow die mit „Set this“ markierten Konfigurationsknoten. Wähle dort den eingerichteten Home-Assistant-Server aus und trage dieselbe Entity-ID ein. Diese Zuordnung muss in allen relevanten Bereichen übereinstimmen:

im zentralen Knoten Climate,
im Knoten Away from Alarm,
bei climate.set_temperature,
bei climate.turn_on und climate.turn_off.

Prüfe vor dem Speichern, ob deine Entität die benötigten Climate-Funktionen unterstützt. In Home Assistant zeigt die Entitätsseite mögliche Betriebsarten, Zieltemperatur sowie Ein- und Ausschaltfunktionen an. Einige Geräte akzeptieren nur feste Temperaturstufen. Dann kann eine Eingabe in 0,1-Grad-Schritten zwar im Dashboard erscheinen, vom Gerät aber gerundet oder abgelehnt werden.

Ein schneller Test spart später Sucharbeit: Ändere die Zieltemperatur zunächst um nur 0,1 oder 0,5 Grad und beobachte den Status in Home Assistant. Reagiert die Entität nicht, kontrolliere zuerst die Entity-ID, danach den ausgewählten Server und zuletzt die unterstützte Betriebsart. Erst wenn dieser Einzelbefehl funktioniert, solltest du weitere Automationen aktivieren.

Verwende bei mehreren Heizkörpern jeweils die richtige Entität. Ein Flow für climate.wohnzimmer steuert nicht automatisch climate.schlafzimmer. Für mehrere Räume brauchst du getrennte Konfigurationen oder eine bewusst angelegte Gruppenlogik.

Betroffene Climate-Nodes korrekt anpassen

Öffne nacheinander die vier markierten Bereiche und prüfe deren Nachrichtenpfad. Der Node Climate verarbeitet die zentrale Thermostatlogik. Away from Alarm begrenzt die Temperatur im Abwesenheitsmodus. Die drei Service-Nodes senden konkrete Befehle an Home Assistant.

climate.set_temperature: Kontrolliere das Feld für die Zieltemperatur. Der Wert muss als Zahl ankommen, nicht als Text mit dem Zusatz „°C“.
climate.turn_on: Prüfe, ob der Dienst für deine Entität unterstützt wird. Manche Geräte starten stattdessen über eine passende HVAC-Betriebsart.
climate.turn_off: Dieser Dienst beendet die Heizanforderung. Teste ihn separat, damit ein Countdown nicht versehentlich dauerhaft weiterheizt.
Away from Alarm: Setze eine niedrige, aber sinnvolle Höchsttemperatur. Ein Wert von etwa 16 bis 18 °C schützt Räume eher vor Auskühlung als ein vollständiges Abschalten.

Öffne jeden Node per Doppelklick und vergleiche die ausgewählte Entität, den Dienst und die Datenfelder. Besonders wichtig ist die Schreibweise von temperature. Home Assistant erwartet dort normalerweise einen numerischen Wert. Ein Payload wie {"temperature":21.5} ist korrekt; ein frei formulierter Text kann dagegen scheitern.

Beachte die erlaubten Temperaturgrenzen des Geräts. Ein Thermostat kann beispielsweise nur Werte zwischen 7 und 30 °C akzeptieren. Liegt der Zielwert außerhalb dieses Bereichs, weist Home Assistant den Befehl zurück oder korrigiert ihn.

Nutze für die Prüfung zunächst einen einzelnen manuellen Eingang. Beobachte im Debug-Fenster, ob der Payload den erwarteten Wert enthält und ob Home Assistant den neuen Zustand meldet. Erst wenn Eingang, Service-Aufruf und Rückmeldung zusammenpassen, sind die Climate-Nodes sauber abgestimmt.

Bei mehreren Betriebsarten darf nur der aktive Pfad einen neuen Zielwert senden. Sonst kann ein Wochenplan den manuellen Wert direkt wieder überschreiben. Eine klare Priorität zwischen Wochenplan, Countdown, manuellem Modus und Away-Zustand verhindert dieses Durcheinander.

Den Flow deployen und die Verbindung prüfen

Klicke oben rechts in Node-RED auf Deploy und wähle die vollständige Bereitstellung des Flows. Warte, bis Node-RED den Vorgang bestätigt. Erst danach laufen die geänderten Verbindungen aktiv.

Öffne anschließend das Dashboard des Thermostats. Eine geladene Oberfläche allein beweist noch keine funktionierende Verbindung. Entscheidend ist, ob der Flow einen aktuellen Zustand von Home Assistant empfängt und im Dashboard anzeigt.

Prüfe, ob ein Status wie Idle, Heat oder OFF erscheint.
Ändere die Zieltemperatur geringfügig über das Dashboard.
Kontrolliere in Home Assistant, ob der neue Wert übernommen wird.
Beobachte das Node-RED-Debugfenster auf Fehlermeldungen.

Bleibt der Status leer, öffne die Seitenleiste Debug. Meldungen wie „connection refused“, „entity not found“ oder „unauthorized“ weisen auf unterschiedliche Ursachen hin: Ein Verbindungsfehler betrifft meist den Serverzugang, eine unbekannte Entität die Zuordnung und eine Berechtigungsfehlermeldung das verwendete Zugangstoken.

Teste auch die Rückrichtung: Ändere die Temperatur direkt in Home Assistant und prüfe, ob das Dashboard den neuen Wert übernimmt. Nur wenn beide Wege funktionieren, ist die Verbindung vollständig. Ein einseitiger Test kann täuschen, weil ein Befehl zwar gesendet, der tatsächliche Gerätezustand aber nicht zurückgemeldet wird.

Führe die Prüfung zuerst bei ausgeschalteter Heizanforderung durch. Aktiviere anschließend kurz den Heizbetrieb und kontrolliere, ob der Status wechselt. Lass den Test nicht unbeaufsichtigt laufen; einige Heizsysteme reagieren mit Verzögerung, besonders wenn Ventile oder Wärmeerzeuger erst anlaufen müssen.

Wenn alles korrekt arbeitet, sichere den Flow erneut und dokumentiere Zeitpunkt sowie verwendetes Gerät. Das erleichtert die Fehlersuche, wenn ein Update oder eine Netzwerkänderung den Ablauf später beeinflusst.

Wochenplaner mit Zeit- und Temperaturvorgaben einrichten

Öffne im Thermostat-Dashboard den Wochenplaner und bearbeite die einzelnen Tagesfelder. Lege für jeden Zeitraum eine Startzeit und die gewünschte Zieltemperatur fest. Ein einfacher Plan könnte so aussehen:

06:30 Uhr: 20,5 °C
08:30 Uhr: 17,5 °C
16:00 Uhr: 20,5 °C
22:30 Uhr: 17,0 °C

Die Werte bilden Schaltpunkte. Zwischen zwei Zeitpunkten hält der Thermostat den zuletzt gesetzten Sollwert. Achte deshalb darauf, dass jeder Tag mit einem gültigen Startwert beginnt. Fehlt dieser Eintrag, kann der Flow nach einem Neustart keinen eindeutigen Zielwert bestimmen.

Übertrage einen fertigen Tagesablauf nur dann auf weitere Wochentage, wenn die Nutzung wirklich gleich ist. Werktage und Wochenende benötigen meist unterschiedliche Zeiten. Ein gemeinsamer Plan führt sonst schnell zu unnötigem Heizen am Vormittag oder zu einem kalten Wohnraum nach der Rückkehr.

Plane Temperaturänderungen mit etwas Vorlauf. Heizkörper reagieren nicht sofort, besonders in großen oder schlecht gedämmten Räumen. Soll es um 18 Uhr angenehm sein, kann ein Start um 17:30 Uhr sinnvoll sein. Die passende Vorlaufzeit hängt von Raum, Heizkörper und Gebäude ab.

Prüfe die Reihenfolge der Schaltpunkte. Eine spätere Zeit darf nicht vor der früheren liegen. Kontrolliere nach dem Speichern, ob die Anzeige jeden Eintrag am richtigen Wochentag zeigt.

Der Away-Modus dient als Begrenzung für Zeiten ohne Bewohner. Setze dafür eine feste Maximaltemperatur, statt den normalen Tagesplan einfach weiterlaufen zu lassen. Nach der Rückkehr muss der reguläre Wochenplan wieder Vorrang erhalten; andernfalls bleibt die reduzierte Temperatur aktiv.

Teste den Plan zunächst mit nah beieinanderliegenden Schaltpunkten. So erkennst du schnell, ob Zeitwechsel, Temperaturübergabe und Anzeige korrekt arbeiten. Danach kannst du die endgültigen Zeiten eintragen.

Countdown-Modus für zeitlich begrenztes Heizen nutzen

Wechsle im Dashboard in den Countdown-Modus, wenn die Heizung nur für eine begrenzte Dauer laufen soll. Lege Laufzeit und Zieltemperatur fest. Der Flow hält diesen Wert bis zum Ablauf und beendet danach die zeitlich begrenzte Anforderung.

Ein typischer Einsatz ist ein warmes Badezimmer für 30 Minuten. Stelle beispielsweise 22,0 °C und eine Dauer von 30 Minuten ein. Nach dem Start sollte der Countdown sichtbar laufen.

Countdown-Modus öffnen
Laufzeit festlegen
Zieltemperatur eintragen
Countdown starten
Nach Ablauf den Folgezustand kontrollieren

Wichtig ist die Einstellung countdown_followed_by. Sie bestimmt, was nach dem Ablauf geschieht. Je nach Flow kann anschließend der Wochenplan wieder greifen, der manuelle Zustand bestehen bleiben oder die Heizung ausgeschaltet werden. Für ein kurzes Aufheizen vor dem Schlafengehen ist die Rückkehr zum Wochenplan meist sinnvoll.

Vermeide mehrere gleichzeitig gestartete Countdowns. Ein neuer Countdown kann den vorherigen Wert überschreiben oder dessen Ablauf unklar machen. Starte erst dann eine neue Laufzeit, wenn der alte Vorgang beendet oder bewusst zurückgesetzt wurde.

Prüfe nach dem Ablauf nicht nur die Anzeige, sondern auch den tatsächlichen Betriebszustand. Der Countdown kann beendet sein, während das Thermostat noch kurz nachregelt. Entscheidend ist, dass der definierte Folgezustand an Home Assistant übertragen wurde.

Bricht der Timer unerwartet ab, kontrolliere Systemzeit und Timeout-Pfad. Gerade bei Neustarts von Node-RED kann ein flüchtiger Countdown verloren gehen. Für längere Abwesenheiten eignet sich der Wochenplan mit Away-Begrenzung besser.

Manuelle Steuerung und Away-Modus konfigurieren

Wechsle in den Modus Manuell, wenn eine kurzfristige Abweichung vom Zeitplan nötig ist. Stelle die gewünschte Zieltemperatur ein. Der manuelle Wert bleibt aktiv, bis du einen anderen Modus auswählst oder der Flow eine neue Priorität erhält.

Der Status Heat zeigt eine aktive Heizanforderung. Idle bedeutet, dass das Thermostat derzeit nicht nachheizt, obwohl eine Zieltemperatur gesetzt sein kann. Eine eingestellte Temperatur allein bedeutet daher nicht, dass der Wärmeerzeuger gerade läuft.

Öffne den manuellen Modus.
Setze die gewünschte Temperatur.
Prüfe den angezeigten Betriebsstatus.
Beende die manuelle Steuerung nach dem Bedarfseinsatz.
Wähle danach wieder den passenden Automatikmodus.

Aktiviere den Away-Modus, bevor die Wohnung längere Zeit leer steht. Er begrenzt die maximal zulässige Temperatur und verhindert, dass ein aktiver Plan unnötig weiterheizt. Für viele Wohnungen sind 16 bis 18 °C ein brauchbarer Ausgangspunkt; die richtige Einstellung hängt von Dämmung, Feuchte und Frostschutz ab.

Der Away-Zustand sollte eindeutig Vorrang vor manuellen Eingaben haben. Prüfe nach dem Aktivieren die Anzeige Away und kontrolliere, ob die Begrenzung tatsächlich übernommen wurde.

Nach der Rückkehr deaktivierst du den Away-Modus wieder. Warte kurz auf die Statusaktualisierung und prüfe, welcher Betriebsmodus aktiv ist. Bleibt Away sichtbar, liegt häufig ein nicht zurückgesetzter Zustand im Flow vor. Ein erneuter Moduswechsel stellt die gewünschte Priorität meist wieder her.

Verwende die manuelle Steuerung nicht als Ersatz für einen Tagesplan. Sie ist für spontane Situationen gedacht, etwa Gäste, Krankheit oder einen ungeplanten Aufenthalt. Für regelmäßige Abweichungen ist ein eigener Zeitplan sauberer und leichter nachvollziehbar.

Statusanzeige, Temperaturdiagramm und Daten speichern

Die Statusanzeige zeigt auf einen Blick, wie der Heizungsablauf arbeitet. OFF steht für eine ausgeschaltete Anforderung, ON für einen aktiven Einschaltzustand, Idle für eine vorübergehende Heizpause und Heat für laufenden Heizbetrieb. Away kennzeichnet die Begrenzung für Abwesenheitszeiten.

Beurteile den Status zusammen mit Ziel- und Isttemperatur. Ein Thermostat kann Idle anzeigen, obwohl der Sollwert unverändert bleibt. Das ist normal, wenn die Raumtemperatur den Zielwert erreicht hat. Ein einzelner Statuswechsel beweist daher nicht automatisch einen Fehler.

Das integrierte Diagramm stellt Temperaturverlauf und Betriebszustände zeitlich dar. Nutze es, um kurze Heizzyklen, lange Aufheizphasen oder auffällige Sprünge zu erkennen. Steigt die Raumtemperatur trotz wiederholtem Heat kaum, liegt möglicherweise ein Problem am Ventil, Sensor oder Wärmeerzeuger vor.

Die Diagrammdaten werden im Flow zwischengespeichert und nach dem Laden wiederhergestellt. Die Speicherung ersetzt jedoch keine dauerhafte Messwertaufzeichnung. Für langfristige Auswertungen über Wochen oder Monate brauchst du eine separate Datenbank oder eine dafür vorgesehene Home-Assistant-Historie.

Kurze Ausschläge können durch Messrauschen entstehen.
Lange waagerechte Linien weisen oft auf fehlende Aktualisierungen hin.
Häufige Wechsel zwischen Heat und Idle können auf eine zu enge Regelspanne hindeuten.
Ein leerer Verlauf deutet meist auf einen Neustart oder fehlende Zustandsdaten hin.

Beim Wiederherstellen zählt der Speicherort des Flow-Kontexts. Wird nur der flüchtige Kontext verwendet, gehen die Werte bei einem Neustart verloren. Für einen stabileren Verlauf solltest du in der Node-RED-Konfiguration einen dauerhaften Kontextspeicher aktivieren und anschließend prüfen, ob das Dashboard neue Werte korrekt ergänzt.

Behalte die Diagrammgröße im Blick. Die aktuelle Darstellung ist horizontal ausgerichtet und lässt sich nur begrenzt anpassen. Für die tägliche Kontrolle reicht sie aus; bei vielen Messpunkten wird die Ansicht schnell unübersichtlich. Dann hilft es, den Zeitraum kürzer zu wählen oder alte Verlaufspunkte gezielt zu entfernen.

Bekannte Einschränkungen und geplante Verbesserungen

Die genannte Projektversion ist v3.4. Sie wurde für Node-RED 2.2 angepasst. Bei neueren Node-RED- oder Home-Assistant-Versionen solltest du den Flow deshalb zuerst in einer Testumgebung prüfen. Eine automatische Kompatibilität mit aktuellen Releases ist nicht zugesichert.

Eine wichtige Einschränkung betrifft die Temperaturauflösung: Die Eingabe in 0,1-Grad-Schritten ist im manuellen und im Countdown-Modus vorgesehen. Im Wochenplaner sind diese feinen Schritte in der beschriebenen Version noch nicht vollständig umgesetzt. Plane dort mit den tatsächlich akzeptierten Stufen des Thermostats.

Auch das Diagramm hat Grenzen. Die Darstellung ist horizontal aufgebaut und bietet nur wenige Möglichkeiten zur Größenanpassung. Für kurze Kontrollen reicht sie aus, für langfristige Vergleiche oder mehrere Räume ist sie jedoch kein Ersatz für eine getrennte Verlaufsaufzeichnung.

Der Flow bündelt mehrere Funktionen in einem Dashboard. Dadurch können Zustände bei schnellen Wechseln zwischen Wochenplan, Countdown, manueller Bedienung und Abwesenheit schwer nachvollziehbar werden. Teste insbesondere Übergänge, Neustarts und den Ablauf eines Countdowns. Ein sauber gesetzter Folgezustand ist hier wichtiger als eine möglichst umfangreiche Oberfläche.

Die Änderungsübersicht nennt für frühere Versionen Korrekturen an Zeitzonen, Startanzeige und Countdown-Zuständen. Diese Historie hilft bei der Fehlersuche, ersetzt aber keinen Test mit der eigenen Hardware. Das Projekt ist als GNU General Public License v3.0 veröffentlicht. Prüfe vor einer Änderung am Flow die Lizenzbedingungen und sichere eine unveränderte Kopie.

Als geplante Verbesserungen sind vor allem zwei Punkte relevant:

0,1-Grad-Schritte sollen auch im Wochenplaner verfügbar werden.
Die Diagrammkomponente soll flexibler und besser anpassbar werden.

Die ursprüngliche Projektseite kann unter der genannten Adresse einen HTTP-Fehler 404 liefern. Verlasse dich deshalb nicht auf einen dauerhaft erreichbaren Download. Bewahre die verwendete JSON-Datei, die Versionsnummer und deine eigenen Anpassungen gemeinsam auf. So bleibt der funktionierende Stand nachvollziehbar, selbst wenn sich die Bezugsquelle ändert.

Fazit: Flow testen und Heizungssteuerung im Alltag nutzen

Nach dem ersten Funktionstest sollte der Flow nicht sofort als endgültige Hausautomation gelten. Beobachte ihn zunächst über mehrere Heizzyklen hinweg. So erkennst du, ob Schaltzeiten, Temperaturverlauf und Zustandswechsel auch unter realen Bedingungen zusammenpassen.

Prüfe morgens und abends die Reaktion auf geplante Wechsel.
Kontrolliere das Verhalten nach einem Neustart von Node-RED.
Beobachte, ob ein Strom- oder Netzwerkausfall einen sicheren Zustand hinterlässt.
Vergleiche die Dashboard-Anzeige gelegentlich mit dem echten Raumgefühl.

Lege für den Alltag eine klare Bedienregel fest: Der Wochenplan übernimmt den Normalbetrieb, der Countdown dient nur für kurze Ausnahmen, und manuelle Eingriffe werden anschließend wieder beendet. Diese Ordnung verhindert, dass ein alter Sonderzustand unbemerkt mehrere Tage aktiv bleibt.

Bei sicherheitsrelevanten Heizsystemen darf der Flow keine Schutzfunktion ersetzen. Frostschutz, Kesselüberwachung und mechanische Begrenzungen müssen weiterhin durch die Heizungsanlage selbst arbeiten. Node-RED sollte nur Komfortfunktionen steuern, nicht als einzige Barriere gegen Überhitzung, Frostschäden oder einen dauerhaft laufenden Wärmeerzeuger dienen.

Dokumentiere die fertige Konfiguration knapp: verwendete Flow-Version, Räume, Betriebsmodi und besondere Grenzwerte. Sichere außerdem eine Kopie des funktionierenden Flows, bevor du neue Nodes oder weitere Räume ergänzt.

Damit ist die Heizungssteuerung alltagstauglich eingerichtet. Der eigentliche Mehrwert entsteht durch kleine Anpassungen anhand echter Nutzung: passende Vorlaufzeiten, sinnvolle Absenkphasen und möglichst wenige spontane Überschreibungen. So bleibt der Ablauf verständlich, sparsam und bei Bedarf schnell korrigierbar.