NodeRed Installation auf Home Assistant

Willkommen zum nächsten Schritt in unserem NodeRed Home Assistant Tutorial. Hier zeige ich dir, wie du NodeRed auf deinem Home Assistant (HA) System installierst. Dieser Prozess ist unkompliziert und setzt einige grundlegende Voraussetzungen voraus, die wir gleich besprechen werden.

Voraussetzungen

Bevor wir beginnen, ist es wichtig zu wissen, dass NodeRed als Add-on in HA integriert ist und nur installiert werden muss. Wenn du beabsichtigst, HA außerhalb deines Netzwerks zu nutzen, gehe ich davon aus, dass du bereits Zertifikate in HA installiert hast. Für dieses Tutorial werden wir jedoch auf SSL verzichten, um die Dinge einfach zu halten.

Anleitung zur Installation von NodeRed (Version ab 16.X.X)

Add-on installieren

• Gehe zu Einstellungen -> Add-ons -> Add-on Store.
• Klicke auf das Node-RED Add-on und dann auf Installieren.

Konfiguration einstellen

• Wechsle zum Reiter Konfiguration.
• Um die Konfiguration leserlicher zu gestalten, klicke rechts auf die 3 Punkte und wähle „als YAML bearbeiten“

Hier eine detaillierte Konfiguration, um eure Node-RED-Instanz sicher und funktional optimal zu gestalten:

Beispielkonfiguration

Erläuterungen und Vorteile

1. Log Level
   • Verwendung: log_level: info bestimmt, welche Art von Informationen Node-RED protokolliert.
   • Beispiel: Setzt man es auf info, erhält man grundlegende Betriebsinformationen. Für detaillierte Debug-Informationen wäre debug eine Alternative.
   • Nutzen: Hilft bei der Überwachung des Systems und der Fehlerdiagnose, ohne mit zu vielen Informationen überflutet zu werden.
2. HTTP Authentifizierung
   • http_node: Schützt API-Endpunkte, die über HTTP-In-Nodes erstellt werden. Diese Nodes ermöglichen das Erstellen eigener APIs oder Webhooks.
     • Beispiel: Ein Webhook, der Sensorendaten empfängt, wäre über http://eure-domain:1880/sensor-data erreichbar und erfordert dann Authentifizierung.
   • http_static: Schützt statische Inhalte wie Dashboards und Dateien, die von Node-RED bereitgestellt werden.
     • Beispiel: Ein Dashboard über http://eure-domain:1880/ui zeigt Zustände von Geräten an und benötigt zum Schutz der Daten ebenfalls Authentifizierung.
   • Nutzen: Beide Einstellungen verhindern unbefugten Zugriff und schützen sensible Daten und Systemfunktionen.
3. SSL/TLS
   • Verwendung: ssl: true aktiviert die Verschlüsselung der Datenübertragung, certfile und keyfile geben die Pfade zu den SSL-Zertifikaten an.
   • Voraussetzungen: Ein gültiges SSL-Zertifikat, das zu eurer Domain passt.
   • Nutzen: Schützt die Verbindung zwischen dem Benutzer und dem Node-RED-Server vor Abhören und Manipulation. Besonders wichtig bei Zugriffen aus dem Internet. Ohne SSL könnte die Datenkommunikation abgefangen werden.
4. Zusätzliche Pakete
   • system_packages: z. B. ffmpeg: Wird für die Verarbeitung von Multimedia-Inhalten verwendet, z.B. für die Konvertierung von Videodaten.
   • npm_packages: z. B. node-red-dashboard: Fügt Node-RED visuelle Dashboards hinzu, die zur Überwachung und Steuerung von Systemen verwendet werden können.
   • Nutzen: Erweitert die Funktionalität von Node-RED, z.B. durch Multimedia-Unterstützung und visuelle Steuerungsoberflächen.
5. Initialisierungsbefehle
   • Befehl 1: echo 'Node-RED wird im Produktionsmodus gestartet...' gibt eine Textnachricht aus, um den Startprozess zu bestätigen.
   • Befehl 2: until nc -z -v -w30 homeassistant.local 1883; do echo "Warte auf MQTT Server..." && sleep 5; done wartet, bis der MQTT-Server läuft, um sicherzustellen, dass alle Abhängigkeiten erfüllt sind, bevor Node-RED vollständig startet.
   • Nutzen: Sicherstellt, dass notwendige Dienste laufen und die Umgebung korrekt vorbereitet ist.
6. Credential Secret
   • Verwendung: credential_secret: SuperSecureSecret987! verschlüsselt Zugangsdaten, die in den Flows gespeichert sind.
   • Nutzen: Erhöht die Sicherheit, indem es sicherstellt, dass sensible Informationen wie API-Schlüssel und Passwörter geschützt sind, selbst wenn jemand Zugriff auf die Flow-Dateien erhält.

Add-on starten

• Gehe zum Reiter Informationen.
• Aktiviere die Schieberegler für Beim Booten starten, Watchdog, In der Seitenleiste anzeigen und Automatische Updates (falls gewünscht).
• Drücke den Starten Button, um NodeRed auszuführen.
• Im Reiter Protokoll kannst du den Startvorgang verfolgen. Eventuelle Fehlermeldungen werden hier angezeigt und können zur Fehlerbehebung genutzt werden.