Home Assistant InfluxDB – das Langzeitgedächtnis fürs Smart Home

Passende Hardware im Überblick

Boards – eine Datenbank mag RAM:
Raspberry Pi 5 mit 8GB RAM – die Empfehlung (Link)*
Raspberry Pi 5 mit 16GB RAM – für große Datenbestände (Link)*
Raspberry Pi 5 mit 4GB RAM – die Untergrenze (Link)*
Raspberry Pi 4 Starter-Set – wenn ein Pi 4 vorhanden ist (Link)*
Home Assistant Green – die Fertiglösung ohne Bastelei (Link)*

Speicher – hier entscheidet sich alles:
Geekworm X1001 M.2-HAT – Pflicht bei Datenbanken (Link)*
PCIe M.2 HAT – die Alternative zum X1001 (Link)*
Intenso M.2 NVMe SSD 500GB – günstiger Einstieg (Link)*
Crucial P310 NVMe SSD 500GB – die schnellere Wahl (Link)*
SanDisk Extreme Portable SSD 1TB – per USB angeschlossen (Link)*
SanDisk Extreme A2 128GB – nur als Notlösung (Link)*

Damit der Server durchläuft:
Offizielles 27-W-Netzteil für den Pi 5 (Link)*
Geekworm X1200 USV – schützt die Datenbank vor Stromausfall (Link)*
Waveshare PoE-HAT für den Netzwerkschrank (Link)*
Home Assistant Connect ZBT-2 – liefert die Sensordaten (Link)*

Kurz gesagt: Wozu eine zweite Datenbank neben Home Assistant?

Die Kurzfassung:

• Das Problem: Der Recorder von Home Assistant löscht seine Detaildaten nach zehn Tagen – das ist der Standardwert von purge_keep_days. Wer wissen will, wie warm es im Februar des Vorjahres war, schaut in die Röhre.
• Die Lösung: Home Assistant InfluxDB ist eine Zeitreihen-Datenbank, die parallel mitschreibt und Messwerte über Jahre speichert, ohne das System zu bremsen.
• Der Weg dorthin: Add-on aus den Home Assistant Community Add-ons installieren, Datenbank und Benutzer anlegen, ein paar Zeilen in die configuration.yaml – fertig.
• Die Belohnung: Zusammen mit Grafana entstehen Jahreskurven für Heizung, Stromverbrauch und Solarertrag, die echte Entscheidungen tragen.
• Voraussetzung: Eine NVMe-SSD oder wenigstens eine USB-SSD. Eine Datenbank schreibt permanent, und Speicherkarten überleben das auf Dauer nicht.
• Wann es sich nicht lohnt: Wer nur Licht bei Bewegung schaltet, braucht kein Archiv. Für Stundenmittel reicht die eingebaute Langzeitstatistik.

Home Assistant InfluxDB: Warum die eingebaute Historie nicht reicht

Home Assistant speichert seine Zustände in einer SQLite-Datei namens home-assistant_v2.db. Diese Datenbank ist bewusst als Kurzzeitgedächtnis ausgelegt: Sie hält jede einzelne Zustandsänderung fest, wird dadurch schnell groß und würde das System ausbremsen, wenn sie ewig wüchse. Deshalb räumt der Recorder regelmäßig auf und behält standardmäßig nur zehn Tage.

Als Gegengewicht gibt es die Langzeitstatistik. Sensoren mit passender Kennzeichnung – Temperatur, Energie, Leistung – landen zusätzlich in einer Statistiktabelle, die Stundenwerte dauerhaft aufbewahrt. Für die Energie-Ansicht reicht das völlig. Was fehlt, sind die Rohdaten: der Minutenverlauf eines Heizungsvorlaufs, die Sekundenspitze beim Anlaufen der Wärmepumpe, der genaue Zeitpunkt, an dem ein Fenster offen stand.

Genau diese Lücke schließt eine Zeitreihen-Datenbank. InfluxDB ist auf einen einzigen Zweck optimiert: Messwerte mit Zeitstempel aufnehmen, komprimiert ablegen und über beliebige Zeiträume wieder ausspucken. Die Anbindung an Home Assistant läuft über eine eigene Integration, die jede gewünschte Zustandsänderung zusätzlich in die Datenbank schreibt – ohne dass der Recorder davon etwas merkt.

Der zweite Vorteil der Trennung ist die Unabhängigkeit. Ein Neuaufbau von Home Assistant, ein Wechsel der Hardware oder ein beschädigtes Backup betrifft das Archiv nicht, wenn InfluxDB auf einem eigenen Datenträger liegt. Das gesammelte Wissen über die eigene Immobilie überlebt damit jede Installation.

Home Assistant InfluxDB einrichten – Schritt für Schritt

1. Unterbau prüfen: Läuft Home Assistant noch von der Speicherkarte, ist jetzt der Zeitpunkt für den Umzug auf SSD. Eine Datenbank im Dauerschreibbetrieb ist der sicherste Weg, eine Karte zu ruinieren.
2. Add-on installieren: Einstellungen → Add-ons → Add-on-Store. Unter „Home Assistant Community Add-ons" findet sich InfluxDB. Installieren, in den Optionen bei fehlendem Zertifikat ssl auf false setzen, starten und „Im Seitenpanel anzeigen" aktivieren.
3. Datenbank anlegen: Die Weboberfläche des Add-ons öffnen und dort über die InfluxDB-Verwaltung eine Datenbank homeassistant anlegen. Anschließend einen Benutzer mit Passwort erzeugen und ihm Schreibrechte auf diese Datenbank geben.
4. Integration eintragen: In die configuration.yaml kommt dieser Block:
   influxdb:
     api_version: 1
     host: a0d7b954-influxdb
     port: 8086
     database: homeassistant
     username: homeassistant
     password: dein-passwort
     ssl: false
     verify_ssl: false
     max_retries: 3
     include:
       domains:
         - sensor
   Der ungewöhnliche Hostname ist kein Tippfehler: So heißt der Container des Community-Add-ons im internen Netz.
5. Neu starten und prüfen: Konfiguration prüfen lassen, Home Assistant neu starten. Erscheint im Protokoll keine Fehlermeldung zur InfluxDB, fließen die ersten Werte bereits.
6. Filter schärfen: Statt aller Sensoren gezielt die wertvollen aufnehmen – mit entity_globs lassen sich ganze Gruppen erfassen, mit exclude gezielt Störenfriede aussortieren.
7. Grafana andocken: Das Grafana-Add-on installieren und InfluxDB als Datenquelle eintragen. URL, Datenbankname und Zugangsdaten sind dieselben wie oben – danach entsteht die erste Jahreskurve in wenigen Klicks.
8. Ins Backup aufnehmen: Als Add-on wandert InfluxDB in das normale Home-Assistant-Backup. Bei großen Datenbeständen sollte das Sicherungsziel entsprechend dimensioniert sein.

Recorder, Langzeitstatistik, InfluxDB – was speichert was?

Drei Speicher liegen bei Home Assistant nebeneinander, und viele Anleitungen werfen sie durcheinander. Die Tabelle sortiert das:

Wichtig ist die letzte Zeile: MariaDB ersetzt SQLite als Recorder-Datenbank, ist aber kein Ersatz für ein Langzeitarchiv. Die beiden Werkzeuge lösen verschiedene Probleme und lassen sich problemlos kombinieren. Wer InfluxDB nicht mag, findet mit VictoriaMetrics eine schlankere Alternative, die dieselbe Rolle übernimmt und ebenfalls als Add-on bereitsteht.

Welche Daten sich wirklich lohnen

Alles zu archivieren ist der häufigste Anfängerfehler. Jeder Schalterzustand, jede Anwesenheitserkennung und jeder Netzwerk-Ping landen sonst für alle Ewigkeit in der Datenbank. Sinnvoll sind vor allem diese Gruppen:

• Energie: Zählerstände und Momentanleistung aus dem Smartmeter, dazu die Einspeisung aus dem Balkonkraftwerk. Erst der Jahresvergleich zeigt, ob eine Maßnahme wirklich etwas gebracht hat.
• Wärme: Raumtemperaturen, Vorlauf, Ventilstellungen. Wer Heizkurven optimieren will, braucht Rohdaten im Minutentakt – Stundenmittel verschleiern genau die Effekte, um die es geht.
• Luft: Luftfeuchte und CO2-Werte, gern zusammen mit Fensterkontakten. Daraus wird sichtbar, ob das Lüftungsverhalten im Haus tatsächlich funktioniert.
• Strompreise: Bei einem dynamischen Tarif über Tibber ergibt der Verlauf zusammen mit dem Verbrauch die ehrlichste Rechnung, die es gibt.
• Systemwerte: Prozessortemperatur, Speicherbelegung und Antwortzeiten. Ein schleichendes Problem fällt in einer Halbjahreskurve sofort auf.

Der Speicherbedarf bleibt dabei überschaubar: Berichte aus der Community nennen für ein durchschnittlich ausgestattetes Haus bei vernünftiger Filterung Größenordnungen im niedrigen einstelligen Gigabyte-Bereich pro Jahr. Auf einer SSD ist das ein Rundungsfehler, auf einer Speicherkarte wäre es ein Todesurteil.

Fehler und Stolpersteine

• Alles archivieren: Ohne include schreibt die Integration jede Entität mit. Die Datenbank wächst unnötig, und die Abfragen werden träge. Erst filtern, dann sammeln.
• SSL-Falle: Das Add-on hat die SSL-Option ab Werk aktiv. Wer in der configuration.yaml gleichzeitig ssl: false setzt, bekommt eine Verbindung, die nicht zustande kommt. Beide Seiten müssen zusammenpassen.
• Falscher Hostname: localhost funktioniert nicht. Container erreichen sich über ihren internen Namen, beim Community-Add-on also a0d7b954-influxdb.
• Datenbank auf der Speicherkarte: Der Verschleiß ist real und schlägt oft erst nach Monaten zu – dann meist mitten in der Nacht und ohne Vorwarnung.
• Version verwechselt: Das Add-on liefert die bewährte 1.x-Linie. Wer eine eigene InfluxDB 2 oder 3 betreibt, muss in der Integration api_version: 2 setzen und mit Token, Organisation und Bucket statt mit Benutzername und Datenbank arbeiten.
• Rückwirkend geht nichts: Was vor der Einrichtung passiert ist, lässt sich nicht nachträglich importieren. Deshalb gilt: lieber heute mit grobem Filter starten als in einem halben Jahr perfekt.
• Backup vergessen zu prüfen: Ein Archiv, das nur in einer nie getesteten Sicherung existiert, ist kein Archiv. Eine Wiederherstellung sollte man einmal durchgespielt haben.

Häufige Fragen zu Home Assistant InfluxDB

Bremst InfluxDB mein Home Assistant aus?
Nein. Die Integration schreibt parallel und unabhängig vom Recorder, dessen Datenbank klein und flink bleibt. Auf einem Pi 5 mit SSD ist die zusätzliche Last im Alltag nicht spürbar.

InfluxDB 1, 2 oder 3 – was nehme ich?
Für den Einstieg die 1.x-Linie aus dem Add-on: Sie ist am einfachsten anzubinden und in unzähligen Grafana-Vorlagen abgebildet. Die neueren Generationen arbeiten mit Token und Buckets und lohnen sich vor allem, wenn ohnehin ein separater Server läuft.

Wie viel Speicherplatz brauche ich?
Das hängt allein von der Zahl der archivierten Sensoren und ihrer Schreibfrequenz ab. Mit gezielter Auswahl bleibt es bei wenigen Gigabyte im Jahr, ohne Filter kann sich das leicht verzehnfachen.

Brauche ich zwingend Grafana dazu?
Nicht zwingend, aber fast immer sinnvoll. Ohne Visualisierung liegen die Daten nur herum. Grafana-Panels lassen sich anschließend sogar in das Home-Assistant-Dashboard einbetten.

Kann die Datenbank auch auf einem anderen Rechner laufen?
Ja, und bei größeren Installationen ist das sogar die sauberere Lösung. Als Ziel taugt ein zweiter Pi, ein NAS oder eine virtuelle Maschine unter Proxmox – im Konfigurationsblock wird dann einfach deren Adresse eingetragen.

Was passiert bei einem Stromausfall?
Ein hartes Abschalten während eines Schreibvorgangs kann Datenbanken beschädigen. Eine kleine USV am Pi kostet wenig und verhindert genau dieses Szenario zuverlässig.

Wie werde ich die Datenbank wieder los?
Den Konfigurationsblock aus der configuration.yaml entfernen, neu starten und anschließend das Add-on deinstallieren. Damit verschwinden auch die gesammelten Daten – vorher also überlegen, ob ein Export gewünscht ist.

Fazit

Ein Smart Home ohne Gedächtnis bleibt ein Sammelsurium aus Schaltern. Home Assistant InfluxDB macht daraus ein Messlabor, das Heizkurven, Stromfresser und Solarerträge über Jahre sichtbar macht – und genau daraus entstehen die Entscheidungen, die am Ende Geld sparen. Unsere klare Empfehlung: Richte das Archiv ein, sobald die ersten Energiesensoren im System sind, und starte lieber mit einem groben Filter als gar nicht. Jeder Monat Wartezeit ist ein Monat, der später als Lücke in der Kurve klafft. Zwei Dinge sind dabei nicht verhandelbar: eine SSD als Unterbau und ein Blick auf die include-Liste, bevor der Dienst zum ersten Mal startet. Wer beides beherzigt, hat in fünf Jahren einen Datenschatz, den kein Hersteller-Portal je liefern könnte.

* = Affiliate Link (raspi-config.de ist Teilnehmer des Partnerprogramms von Amazon EU, das zur Bereitstellung eines Mediums für Websites konzipiert wurde, mittels dessen durch die Platzierung von Werbeanzeigen und Links zu Amazon.de Werbekostenerstattung verdient werden kann.)