DEV Community

Marco
Marco

Posted on • Originally published at blog.disane.dev

WebNUT: USV ins SmartHome einbinden

Lerne, wie Du WebNUT in Docker installierst, konfigurierst und in HomeAssistant integrierst, um Deine USV-Geräte im Smart Home zu überwachen. 🏠


In diesem Artikel zeige ich Dir, wie Du WebNUT in Docker installierst und konfigurierst und anschließend in HomeAssistant integrierst. WebNUT ist ein Webinterface für Network UPS Tools (NUT), das es Dir ermöglicht, USV-Geräte (unterbrechungsfreie Stromversorgungen) in Deinem Netzwerk zu überwachen. Die Integration in HomeAssistant erlaubt es Dir, die USV-Daten direkt in Dein Smart Home System einzubinden und so noch mehr Kontrolle und Übersicht zu gewinnen.

Was ist WebNUT und warum solltest Du es nutzen? 🤔

WebNUT ist ein praktisches Tool für alle, die eine USV in ihrem Netzwerk haben. Mit WebNUT kannst Du:

  • Den Status Deiner USV in Echtzeit überwachen.
  • Warnmeldungen und Benachrichtigungen bei Stromausfällen oder anderen Problemen erhalten.
  • Eine zentrale Verwaltung für mehrere USVs haben.

Durch die Integration in HomeAssistant kannst Du zudem automatisierte Aktionen basierend auf dem USV-Status erstellen, z.B. das Herunterfahren von Geräten bei Stromausfällen oder das Senden von Benachrichtigungen.

Vorbereitung: Was Du benötigst 🛠️

Bevor wir loslegen, stelle sicher, dass Du folgende Dinge hast:

  • Einen Docker-fähigen Server (z.B. ein Raspberry Pi oder ein NAS).
  • Eine installierte und funktionierende Docker-Umgebung.
  • HomeAssistant (bereits installiert und konfiguriert).

WebNUT in Docker installieren 🐳

Schritt 1: Docker-Container für WebNUT erstellen

Erstelle einen neuen Docker-Container für WebNUT. Öffne dazu ein Terminal und führe folgenden Befehl aus:

docker run -d \
  --name=webnut \
  -e TZ=Europe/Berlin \
  -p 80:80 \
  --restart unless-stopped \
  --cap-add=NET_ADMIN \
  christronyxyocum/webnut

Enter fullscreen mode Exit fullscreen mode

Dieser Befehl startet einen neuen Docker-Container für WebNUT mit den notwendigen Einstellungen. Stelle sicher, dass der Port 80 verfügbar ist oder passe die Portweiterleitung entsprechend an.

Schritt 2: WebNUT konfigurieren

Nachdem der Container gestartet ist, solltest Du die Konfigurationsdatei bearbeiten, um Deine USV-Geräte hinzuzufügen. Die Konfigurationsdatei findest Du unter /etc/nut/ups.conf. Du kannst den Container betreten und die Datei mit einem Editor wie nano bearbeiten:

docker exec -it webnut /bin/bash
nano /etc/nut/ups.conf

Enter fullscreen mode Exit fullscreen mode

Füge in der Datei die Informationen zu Deiner USV hinzu, z.B.:

[myups]
    driver = usbhid-ups
    port = auto
    desc = "Meine USV"
Enter fullscreen mode Exit fullscreen mode

Speichere die Datei und verlasse den Editor. Starte den NUT-Dienst neu, damit die Änderungen wirksam werden.

WebNUT in HomeAssistant integrieren 🏠

Schritt 1: NUT-Integration in HomeAssistant hinzufügen

Öffne Deine HomeAssistant-Instanz und gehe zu den Integrationen. Füge eine neue Integration hinzu und suche nach "Network UPS Tools (NUT)". Wähle diese aus und konfiguriere sie mit den entsprechenden Einstellungen:

  • Host: IP-Adresse_Deines_WebNUT_Containers
  • Port: 3493
  • Benutzername: Dein_NUT_Benutzername (falls konfiguriert)
  • Passwort: Dein_NUT_Passwort (falls konfiguriert)

Schritt 2: WebNUT in HomeAssistant verwenden

Nach der erfolgreichen Konfiguration sollten die USV-Daten in HomeAssistant verfügbar sein. Du kannst nun Sensoren, Benachrichtigungen und Automatisierungen basierend auf dem USV-Status erstellen. Beispiel für eine Automatisierung:

alias: 'Benachrichtigung bei Stromausfall'
trigger:
  - platform: state
    entity_id: sensor.myups_status
    to: 'OB Discharging'
action:
  - service: notify.notify
    data:
      message: "Achtung! Stromausfall erkannt. USV läuft im Batteriebetrieb."

Enter fullscreen mode Exit fullscreen mode

Fazit 🎉

Mit WebNUT und Docker kannst Du Deine USV einfach und effektiv überwachen. Durch die Integration in HomeAssistant erhältst Du zusätzlich die Möglichkeit, Dein Smart Home noch smarter zu machen, indem Du automatisierte Aktionen basierend auf dem USV-Status einrichtest. Viel Spaß beim Einrichten und Ausprobieren!


If you like my posts, it would be nice if you follow my Blog for more tech stuff.

Top comments (0)