!Eine brennende Kerze vor dunklem Hintergrund, Symbol für einen Stromausfall
Am 8. März 2025 schrieb ein Nutzer in ein Ticket im Home-Assistant-Repository (Issue #115765), dass seine gesamte Historie jede Nacht gegen 4 Uhr verschwindet. Zuverlässig, um 4:12 Uhr. Home Assistant hatte die Datenbank für kaputt erklärt, zur Seite gelegt und mit einer leeren neu angefangen. Er tauschte die SD-Karte, bis zum 5. März herrschte Ruhe, dann ging es wieder los. Der Entwickler emontnemery antwortete am 31. März 2025 ziemlich nüchtern: Der Job um 4:12 Uhr fragt viel in der Datenbank ab und scheitert deshalb nur, wenn sie vorher schon beschädigt wurde. Als Hardware-Ursachen nannte er eine schlechte SD-Karte oder einen USB-Stick, ein schlechtes Netzteil und defekten Arbeitsspeicher.
Die offizielle Dokumentation der Recorder-Integration (Home Assistant 2026.10.4, abgerufen am 26. Oktober 2026) ist noch deutlicher. Wenn SQLite auf nicht reparierbare Schäden stößt, verschiebt Home Assistant die alte Datei und legt eine neue an, damit das System online bleibt. Das sei die letzte Rettung und komme meist von „failing flash storage, an inadequate power supply, an unclean shutdown, or another hardware failure". Ein unsauberes Ausschalten steht also schwarz auf weiß in der Liste. Ein Stromausfall ist der unsauberste Ausschaltvorgang, den es gibt.
Hier steht, wie Sie das verhindern: USV, NUT-Integration, Benachrichtigung aufs Handy, und danach eine Checkliste für alles, was nach dem Neustart wieder anlaufen muss.
Was bei einem Stromausfall tatsächlich passiert
Home Assistant schreibt ständig. Laut Recorder-Dokumentation werden Ereignisse und Zustandsänderungen standardmäßig alle fünf Sekunden (commit_interval) in die Datenbank übernommen. Fällt der Strom mitten in einem solchen Schreibvorgang aus, ist die Datei womöglich nur halb geschrieben. Meistens geht das gut. Manchmal nicht, und dann lesen Sie ein Jahr Energiedaten nur noch aus dem Backup.
Es muss nicht gleich die Datenbank sein. Genauso gut kann es sein, dass alles hochfährt und nur ein paar Geräte fehlen oder die Heizung im falschen Modus steht. Dazu weiter unten mehr. Zuerst die Absicherung.
Eine USV (unterbrechungsfreie Stromversorgung) löst zwei Aufgaben. Sie überbrückt kurze Aussetzer, bei denen sonst alles neu startet. Und sie gibt dem Rechner bei einem langen Ausfall die Zeit, sich selbst sauber auszuschalten. Für die zweite Aufgabe muss die USV dem Rechner aber irgendwie Bescheid sagen. Dafür gibt es NUT.
NUT in zwei Sätzen
Network UPS Tools ist ein Open-Source-Projekt, das mit einheitlichem Zugriff Stromversorgungsgeräte überwacht, darunter USVs. Laut Dokumentation der Home-Assistant-NUT-App sind mehr als 140 Hersteller und mehrere tausend Modelle kompatibel. Ob Ihr Modell dabei ist, prüfen Sie in der Hardware-Kompatibilitätsliste auf networkupstools.org, bevor Sie kaufen.
Wichtig ist die Arbeitsteilung, die die Home-Assistant-Dokumentation ausdrücklich beschreibt: Die Integration kann nicht direkt mit der USV sprechen. Sie braucht einen NUT-Server, mit dem sie über das NUT-Protokoll kommuniziert. Home Assistant ist also nur der Zuschauer. Das Herunterfahren organisiert NUT, genauer der Dienst upsmon.
Einrichtung bei Home Assistant OS
Wer Home Assistant OS betreibt, nutzt die Community-App „Network UPS Tools" (früher Add-on). Ihre Dokumentation beschreibt die Schritte: App installieren, die Optionen users und devices konfigurieren, App starten, den Hostnamen auf dem Info-Tab notieren und die NUT-Integration mit diesem Hostnamen, Port 3493 sowie dem konfigurierten Benutzer einrichten.
Ein Konfigurationsbeispiel aus der App-Dokumentation, im Aufbau übernommen (Passwort natürlich ändern):
users:
- username: nutty
password: changeme
instcmds:
- all
actions: []
devices:
- name: myups
driver: usbhid-ups
port: auto
config: []
mode: netserver
shutdown_host: "false"
Zwei Dinge daran verdienen Aufmerksamkeit.
shutdown_host: Bei false stoppt im Ernstfall nur die App, nicht der Rechner. Die Dokumentation sagt, das sei zum Testen ohne Folgen gedacht. Für den Dauerbetrieb muss der Wert "true" sein, sonst haben Sie eine hübsche Überwachung, die im Ernstfall nichts tut.
driver: usbhid-ups passt für viele USB-Geräte, aber nicht für alle. Welcher Treiber zu Ihrer USV gehört, steht in der NUT-Kompatibilitätsliste. Wenn mehrere USB-Geräte am Rechner hängen, hilft die Option list_usb_devices: true, die angeschlossene Geräte beim Start ins Protokoll schreibt.
Läuft Home Assistant dagegen als Container oder auf einem eigenen Linux-System, installieren Sie NUT selbst. Dann gehört in die upsmon.conf mindestens eine MONITOR-Zeile, MINSUPPLIES und, wenn der Rechner direkt an der USV hängt, ein POWERDOWNFLAG (alles laut Manpage upsmon.conf). Ein SHUTDOWNCMD wie /sbin/shutdown -h +0 legt fest, womit der Rechner heruntergefahren wird.
Die Integration in Home Assistant
Die offizielle Doku (home-assistant.io/integrations/nut, Stand 2026.10.4) nennt ein paar Voraussetzungen, die man gerne überliest.
Die IP-Adresse des NUT-Servers kann Home Assistant nicht automatisch nachführen. Geben Sie dem Server eine feste Adresse, eine DHCP-Reservierung oder einen DNS-Namen. Sonst läuft die Integration nach dem nächsten Router-Neustart ins Leere.
Ohne Benutzername und Passwort funktioniert nur die Anzeige. Schaltflächen, Schalter und Geräteaktionen gibt es nur, wenn der Benutzer in der upsd.users die Berechtigung instcmds hat. Für reine Überwachung ist das nicht nötig.
Die Integration fragt den Server standardmäßig alle 60 Sekunden ab. Das ist wichtig für die Benachrichtigung, aber nicht für die Sicherheit. Über das Herunterfahren entscheidet upsmon direkt am NUT-Server, ohne auf Home Assistant zu warten. Die Manpage upsmon.conf beschreibt für ein verschwundenes Gerät DEADTIME (Standard 15 Sekunden): Meldet sich eine USV, die zuletzt im Batteriebetrieb war, nicht mehr, gilt sie als „Low Battery". Das ist unbequem, aber gewollt, denn die Alternative wäre, blind in den Ausfall zu laufen.
Sichtbar werden unter anderem „Battery charge", „Load" und „Status". Der Sensor „Battery runtime (secs)", also die geschätzte Restlaufzeit, gehört zu den Diagnosesensoren und ist laut Doku standardmäßig abgeschaltet, wie die meisten davon. Wer ihn möchte, aktiviert ihn von Hand. Das lohnt sich, denn diese Zahl zeigt Ihnen zum ersten Mal ehrlich, wie lange die Batterie Ihr System wirklich trägt, und sie wird mit dem Alter der Batterie kleiner.
Ausfall aufs Handy melden
Die Dokumentation liefert zwei fertige Automatisierungen. Die erste meldet, wenn der Status-Sensor auf „On Battery, Battery Discharging" wechselt:
alias: "Notify when the UPS switches to battery"
triggers:
- trigger: state
entity_id: sensor.ups_status
to: "On Battery, Battery Discharging"
actions:
- action: notify.send_message
target:
entity_id: notify.my_device
data:
message: "The UPS lost power and is now on battery."
Die zweite löst aus, wenn der Ladestand unter 25 Prozent fällt (numeric_state auf sensor.ups_battery_charge, below: 25). Die Entitätsnamen und das Benachrichtigungsziel müssen Sie an Ihre Installation anpassen, die Doku nutzt notify.my_device als Platzhalter. Schreiben Sie die Meldung auf Deutsch und so, dass Sie sie nachts um drei auch ohne Brille verstehen.
Ein Haken, den keine Dokumentation erwähnt, weil er von Ihrem Haus abhängt: Eine Push-Nachricht aufs Handy braucht Internet. Hängt nur der Home-Assistant-Rechner an der USV, nicht aber Router und WLAN-Access-Point, sendet das System seine Warnung ins Leere. Einschätzung: Router und Modem gehören an dieselbe USV oder an eine zweite, damit die Meldung überhaupt ankommt. Eine kleine USV mit einigen Watt Last hält so etwas deutlich länger durch als ein ganzer Server.
Der Test, den fast niemand macht
Bevor Sie dem System vertrauen, lösen Sie den Ernstfall aus, bei laufendem System und aktuellem Backup (mehr dazu im Artikel zur Backup-Strategie). Es gibt zwei Wege.
Der erste ist der ehrliche: Netzstecker der USV ziehen und zuschauen. Kommt die Benachrichtigung? Fährt der Rechner bei niedriger Batterie sauber herunter? Geht die USV danach aus und startet bei Netzrückkehr neu? Das letzte ist der Zweck des POWERDOWNFLAG: Die Manpage erklärt, das diene dazu, die abhängigen Systeme zurückzusetzen, damit sie nicht im „halted"-Zustand hängen bleiben, falls der Strom während des Herunterfahrens zurückkommt.
Der zweite Weg ist der sanfte. Die Manpage zu upsmon beschreibt, dass sich ein erzwungenes Herunterfahren mit upsmon -c fsd auslösen lässt, auf dem System, auf dem upsmon im Primärmodus läuft. Vorsicht: Laut derselben Manpage lässt sich das „FSD"-Flag nur durch einen Neustart des Datendienstes wieder entfernen. Machen Sie diesen Test also nicht nebenbei.
Nach dem Neustart: Was wirklich wieder anlaufen muss
Hier enden die meisten Anleitungen, obwohl es erst anfängt. Home Assistant ist hochgefahren, die Oberfläche öffnet sich, alles grün. Aber ist das Haus auch wieder im Normalzustand?
Heizung
Die Heizung ist der Fall, bei dem ein Stromausfall im Winter wehtut. Wenn Home Assistant Ihre Heizung regelt, etwa mit einem virtuellen Thermostat, muss das System nach dem Start wissen, in welchem Modus es war.
Für den generic_thermostat sagt die Dokumentation zwei konkrete Dinge. Setzen Sie keine target_temp, ist die Zieltemperatur beim Start null. Seit Version 0.59 behält das Thermostat die vor dem Neustart eingestellte Zieltemperatur, falls sie verfügbar ist. Und mit initial_hvac_mode lässt sich der Startmodus festlegen (off, heat oder cool). Ist der Parameter nicht gesetzt, empfiehlt die Doku, einen keep_alive-Wert zu setzen. Das dient dazu, Abweichungen zwischen Thermostat und Heizungsschalter auszugleichen: Das Schaltsignal wird dann in festen Abständen erneut gesendet, auch für Geräte, die ihren Zustand verlieren können.
Daraus ergibt sich eine einfache Faustregel: Wenn Ihre Heizung nach einem Neustart zuverlässig anlaufen soll, setzen Sie keep_alive. Das kostet nichts und deckt den Fall ab, dass der Schalter nach dem Stromausfall in einem anderen Zustand ist als das Thermostat glaubt.
Für alles, was damit nicht abgedeckt ist, hilft eine Automatisierung beim Start von Home Assistant. Ein Beispiel (Entitätsname anpassen):
alias: "Heizung nach Neustart prüfen"
triggers:
- trigger: homeassistant
event: start
actions:
- delay: "00:02:00"
- action: climate.set_hvac_mode
target:
entity_id: climate.wohnzimmer
data:
hvac_mode: heat
Die Verzögerung gibt Zigbee, Z-Wave und Matter Zeit, ihre Geräte zu finden. Wie Sie smarte Heizkörperthermostate sinnvoll einsetzen, steht im Artikel zu den smarten Heizkörperthermostaten, und wer die Regelung mit dem Versatile Thermostat übernimmt, findet die Einrichtung im Beitrag zum Versatile Thermostat.
Zigbee und der Dongle
Der Funk-Dongle ist beim Neustart die zweite Stelle, an der es hakt. Die ZHA-Dokumentation hat dafür zwei Einstellungen, die man kennen sollte. Mit „Refresh mains-powered devices state on startup" (Standard: an) fragt ZHA beim Start netzbetriebene Geräte ab. Bei großen Netzen kann das zu Stau führen, die Doku nennt ausdrücklich den Fall langsamer Geräte nach einem Neustart. Und: Ein netzbetriebenes Gerät ohne Aktivität gilt nach 7.200 Sekunden (zwei Stunden) als nicht verfügbar, ein batteriebetriebenes nach 21.600 Sekunden (sechs Stunden). Wer nach einem Stromausfall schneller sehen will, welche Steckdose oder Lampe nicht zurückgekommen ist, kann den ersten Wert senken, die Doku nennt als Beispiel 3.600.
Die Dokumentation empfiehlt außerdem eine USB-Verlängerung, möglichst an einem USB-2.0-Port, weil USB-3-Störungen den Funk beeinträchtigen. ZHA legt zudem automatisch Sicherungen des Zigbee-Netzes an. Prüfen Sie nach einem Stromausfall trotzdem, ob unter Einstellungen > Geräte & Dienste alle Geräte wieder erreichbar sind.
Z-Wave
Bei Z-Wave liegt das Netz laut Doku dauerhaft im Adapter, die zusätzlichen Metadaten aber nicht. Beim ersten Start der Integration wird das ganze Netz „interviewt", was bei vielen Geräten dauert. Das Netz selbst bleibt also im Adapter gespeichert, die Metadaten holt die Integration sich beim Start.
Matter
Ein Fall aus dem Issue-Tracker der Home-Assistant-Add-ons (Issue #4214, geöffnet am 4. November 2025, geschlossen am 8. Juli 2026) zeigt, dass es hier knifflig werden kann. Ein Nutzer meldete, dass nach jedem Neustart seine Matter-Geräte offline waren, im WLAN wie im Thread-Netz, und erst wieder auftauchten, wenn er jedes Gerät in der Oberfläche anklickte. Ein anderer Teilnehmer schrieb am 24. November 2025, bei ihm sei das Problem nach einem „harten" Neustart durch Kappen der Stromzufuhr aufgetreten. Eine einzelne Ursache wurde in dem Ticket nicht bestätigt; Teilnehmer nannten wechselnde Auslöser, von mDNS-Weiterleitung zwischen VLANs bis zum Neustart einzelner Geräte. Praktische Konsequenz: Nach einem Stromausfall gehört ein Blick auf die Matter-Geräte zur Routine, und wer eine USV hat, spart sich diese Fehlersuche im besten Fall ganz.
Eine Checkliste für den Morgen danach
Wenn der Strom weg war, gehen Sie diese Punkte durch:
- Stehen Datenbank und Verlauf? Unter Einstellungen > System > Protokolle nach Fehlern des Recorders suchen. Eine zur Seite gelegte Datei erkennen Sie am Namenszusatz „.corrupt" im Konfigurationsordner.
- Sind alle Zigbee-, Z-Wave- und Matter-Geräte verfügbar?
- Steht die Heizung im richtigen Modus, und stimmt die Zieltemperatur?
- Hat die NUT-Integration wieder Verbindung zur USV, und zeigt der Status „Online"?
- Wie viel Batterie ist verblieben? Eine USV, die gerade einen langen Ausfall überstanden hat, braucht Zeit zum Aufladen.
Was an Ihrer Stelle zu tun ist
Kaufen Sie die USV nicht nach Leistung, sondern nach Treiberunterstützung. Ein Blick in die NUT-Kompatibilitätsliste erspart den Umtausch. Stellen Sie sicher, dass Router und Access-Point mit an der USV hängen. Setzen Sie shutdown_host auf "true", nachdem Sie getestet haben. Und legen Sie keep_alive für die Heizung fest. Mehr braucht es nicht, damit ein Stromausfall im Januar kein Wochenendprojekt wird.
Quellen
- Home Assistant, Integration Network UPS Tools (NUT), Version 2026.10.4: home-assistant.io/integrations/nut (abgerufen am 26. Oktober 2026)
- Home Assistant, Integration Recorder, 2026.10.4: home-assistant.io/integrations/recorder
- Home Assistant, Integration Generic Thermostat und Zigbee Home Automation (ZHA) sowie Z-Wave, 2026.10.4
- Home Assistant Community App Network UPS Tools, DOCS.md: github.com/hassio-addons/addon-nut
- Network UPS Tools, Manpages
upsmon.conf(5)undupsmon(8): networkupstools.org/docs/man/ - GitHub, home-assistant/core, Issue #115765 „Database corruption during purge"
- GitHub, home-assistant/addons, Issue #4214 „Matter devices offline after system reboot"