Nie wieder Datenverlust: Home Assistant Time Machine Setup

Hast du schon einmal diesen Moment erlebt? Du sitzt abends an deinem Dashboard, änderst „nur mal kurz“ eine Zeile in deiner configuration.yaml oder in einer komplexen Automatisierung – und plötzlich geht nichts mehr. Der Bildschirm wird rot, Fehlermeldungen fliegen dir um die Ohren, oder schlimmer: Die Automatisierung, die seit Monaten perfekt lief, ist einfach weg oder kaputtüberschrieben.

Das klassische Home Assistant Backup ist großartig, aber es ist oft wie das Schießen mit Kanonen auf Spatzen. Willst du wirklich das komplette System von heute Nacht um 3:00 Uhr wiederherstellen und damit alle Daten (Energieverbräuche, Zustände) der letzten 12 Stunden verlieren, nur weil du eine Datei verpfuscht hast?

Hier kommt die Home Assistant Time Machine ins Spiel.

In diesem ultimativen Guide zeige ich dir, wie du dieses geniale Tool installierst, konfigurierst und nutzt. Wir schauen uns die Installation als Add-On (die einfachste Methode) und als Standalone-Container (für die Docker-Profis) an.

Für eine detaillierte Anleitung und Erklärung aller Konfigurationsmöglichkeiten empfehle ich das unten verlinkte YouTube-Video. In diesem Video wird ausführlich auf jede einzelne Einstellung eingegangen, sodass du eine umfassende Anleitung zur genauen Einrichtung erhältst. Eventuellen Code aus dem Video findest du in diesem Beitrag, so dass du ihn direkt nutzen kannst, ohne abtippen zu müssen.

Dieser Blogbeitrag inklusive Video ist Teil einer Serie, in der wir unseren eigenen Homeserver erstellen und einrichten. Wir fangen bei den Basics an, wie einer Ubuntu-VM-Installation mit Docker, und machen dann weiter mit der Konfiguration einer eigenen Domain, Sicherheitsvorkehrungen und vor allem mit jeder Menge coolen und nützlichen selbstgehosteten Diensten. Egal ob Medienserver wie Plex oder Jellyfin oder Dokumentenmanagement wie Paperless-NGX. Wir bauen gemeinsam das Setup auf, das ihr sehen möchtet. Selbst Themen wie Single Sign-On (SSO) gehen wir gemeinsam an.

Was ist Home Assistant?

Home Assistant ist eine Open-Source-Plattform für die Heimautomatisierung, die darauf abzielt, alle Geräte im Haus miteinander zu verbinden und zentral zu steuern. Sie wurde entwickelt, um eine einheitliche Benutzeroberfläche und eine einfache, flexible Steuerung für eine Vielzahl von Smart-Home-Geräten aus unterschiedlichen Ökosystemen zu bieten. Hier sind einige Punkte, die für Home Assistant sprechen:

1. Kompatibilität: Home Assistant unterstützt Tausende von Geräten und Diensten von verschiedenen Herstellern, einschließlich Beleuchtung, Klimaanlagen, Heizungen, Kameras, Wettersensoren, Sprachassistenten und mehr.
2. Lokale Steuerung: Im Gegensatz zu vielen kommerziellen Smart-Home-Plattformen, die auf Cloud-Dienste angewiesen sind, läuft Home Assistant lokal in deinem Netzwerk. Dies bedeutet erhöhte Privatsphäre und Zuverlässigkeit, da deine Smart-Home-Geräte auch ohne aktive Internetverbindung funktionieren.
3. Automatisierung und Szenen: Eines der Hauptmerkmale von Home Assistant ist die Möglichkeit, komplexe Automatisierungen und Szenarien zu erstellen. Du kannst beispielsweise Lichter automatisch einschalten lassen, wenn es dunkel wird, oder die Heizung einschalten, wenn die Temperatur unter einen bestimmten Wert fällt.
4. Einfache Benutzeroberfläche: Home Assistant bietet eine nutzerfreundliche Oberfläche, die es einfach macht, Geräte zu überwachen und zu steuern. Diese Oberfläche ist vollständig anpassbar.
5. Integration mit Sprachassistenten: Home Assistant kann mit Sprachassistenten wie Amazon Alexa oder Google Assistant integriert werden, um eine sprachgesteuerte Steuerung deiner Smart-Home-Geräte zu ermöglichen.
6. Open-Source und Community-Getrieben: Da Home Assistant Open-Source ist, wird es von einer aktiven Community unterstützt, die ständig neue Integrationen entwickelt und bestehende verbessert.
7. Datenschutz und Sicherheit: Als lokal laufende Plattform hat Home Assistant den Vorteil, dass die Daten im eigenen Netzwerk bleiben. Dies schützt die Privatsphäre und erhöht die Sicherheit im Vergleich zu Cloud-basierten Lösungen.

Zusammenfassend ist Home Assistant eine leistungsstarke und flexible Lösung für diejenigen, die ihr Smart Home selbst gestalten und ihre Geräte unabhängig vom Hersteller oder Ökosystem zentral steuern möchten.

Das Problem: Warum Snapshots nicht genug sind

Home Assistant bietet von Haus aus eine Backup-Funktion. Diese erstellt .tar-Archive, die alles enthalten: Deine Konfiguration, deine Datenbanken, deine Add-Ons. Das ist deine Lebensversicherung, wenn deine SD-Karte im Raspberry Pi abraucht oder deine SSD den Geist aufgibt.

Aber für die tägliche Arbeit („Development“) ist das oft zu grob.

Stell dir vor:

• Du arbeitest an drei verschiedenen Automatisierungen gleichzeitig.
• Zwei funktionieren super, bei der dritten machst du einen Fehler und überschreibst versehentlich funktionierenden Code.
• Dein letztes Voll-Backup ist 24 Stunden alt.

Deine Optionen ohne Time Machine:

1. Du lebst mit dem Fehler und versuchst, ihn aus dem Gedächtnis zu reparieren (nervig).
2. Du stellst das Backup von gestern wieder her. Damit verlierst du aber auch den Fortschritt an den zwei funktionierenden Automatisierungen und alle Sensor-Daten des Tages (schmerzhaft).

Wir brauchen etwas, das feiner arbeitet. Etwas, das uns erlaubt, einzelne Dateien auf einen früheren Zeitpunkt zurückzusetzen, ohne das gesamte System zu berühren. Wir brauchen eine Zeitmaschine.

Was ist Home Assistant Time Machine?

Das Projekt Home Assistant Time Machine, entwickelt und gepflegt von DiggingForDinos (aktuell auf Codeberg gehostet), ist genau das Werkzeug, das diese Lücke schließt.

Es handelt sich um eine Software, die parallel zu deinem Home Assistant läuft. Sie überwacht deine Konfigurationsdateien (.yaml) und erstellt in regelmäßigen Abständen (oder manuell ausgelöst) lokale Sicherungspunkte dieser Textdateien.

Die Kern-Features auf einen Blick:

• Selektiver Restore: Du kannst eine einzige Automatisierung wiederherstellen, ohne den Rest anzufassen.
• Visual Diff: Das ist das Killer-Feature. Du siehst links deine aktuelle (kaputte) Datei und rechts die alte (funktionierende) Version. Das Tool markiert dir farblich genau, was sich geändert hat. Oft reicht ein Blick darauf, um den Tippfehler zu finden, ohne überhaupt etwas wiederherstellen zu müssen.
• Sicherheit: Bevor das Tool eine Datei überschreibt (Restore), macht es automatisch ein Sicherheits-Backup des Ist-Zustands.
• Leichtgewichtig: Im Gegensatz zu Git-Servern oder Cloud-Lösungen läuft es lokal und braucht kaum Ressourcen.

Es ist wichtig zu verstehen, dass Time Machine primär für deine Text-Konfiguration (YAML) gedacht ist, nicht für deine Datenbank (History) oder Medien.

Voraussetzungen

Bevor wir starten, prüfen wir kurz deine Umgebung. Die gute Nachricht: Die Anforderungen sind minimal.

• Home Assistant OS (HAOS) oder Supervised: Für die Add-On-Methode benötigst du Zugriff auf den Add-On Store. Das ist der Standard für die meisten Nutzer auf Raspberry Pis oder Home Assistant Green/Yellow.
• Docker: Falls du Home Assistant „Containerized“ (Core) betreibst, kannst du das Add-On nicht nutzen, musst aber nicht verzichten -> siehe Abschnitt „Standalone Installation“.
• Speicherplatz: Da Time Machine Textdateien sichert, ist der Speicherbedarf minimal. Selbst bei tausenden Versionen reden wir meist nur über wenige Megabytes.

Installation via Home Assistant Add-On (Empfohlen)

Dies ist der Weg, den 95% aller Nutzer gehen sollten. Er integriert sich nahtlos in deine Home Assistant Oberfläche.

Schritt 1: Das Repository hinzufügen

Da das Add-On (noch) nicht im offiziellen Standard-Store von Home Assistant enthalten ist, müssen wir dem Supervisor mitteilen, wo er es findet.

1. Öffne deinen Home Assistant.
2. Navigiere zu Einstellungen -> Add-ons.
3. Klicke unten rechts auf den Button Add-on Store.
4. Klicke oben rechts auf die drei Punkte (Menü) und wähle Repositorys.
5. Füge im Feld folgende URL ein: https://codeberg.org/DiggingForDinos/ha-addons (Hinweis: Falls Codeberg gerade Probleme macht, gibt es oft Spiegel auf GitHub, aber Codeberg ist die offizielle Quelle des Entwicklers).
6. Klicke auf Hinzufügen. Nach kurzer Ladezeit sollte das Repository in der Liste erscheinen.

Schritt 2: Die Installation

1. Schließe das Repository-Fenster.
2. Lade die Seite des Add-on Stores einmal neu (F5 im Browser), damit die neuen Inhalte geladen werden.
3. Scrolle nach unten (oder nutze die Suche) bis zum Bereich „DiggingForDinos Add-ons“.
4. Du wirst dort vermutlich zwei ähnliche Add-ons sehen:
   • Home Assistant Version Control (Das ist für Git-Backups, dazu später mehr).
   • Home Assistant Time Machine (Das wollen wir!).
5. Klicke auf Home Assistant Time Machine.
6. Klicke auf Installieren.
7. Warte einen Moment. Aktiviere währenddessen die Schalter für:
   • Immer aktualisieren (Watchdog): Ja, damit es neu startet, falls es abstürzt.
   • Automatisches Update: Optional, ich mache Updates lieber manuell, um Changelogs zu lesen.
   • In der Seitenleiste anzeigen: UNBEDINGT AKTIVIEREN. Das macht den Zugriff viel bequemer.

Gehe zurück zum Reiter Informationen und klicke auf Starten. Warte ein paar Sekunden und wirf einen Blick in das Protokoll (Log). Wenn dort etwas steht wie „Server started on port…“ und keine roten Error-Meldungen zu sehen sind, hast du es geschafft!

Klicke nun in der linken Seitenleiste von Home Assistant auf den neuen Eintrag „Time Machine“.

Schritt 3: Die Konfiguration

Rufe Time Machine in deiner Seitenleiste auf. Dort kannst du oben auf den Button Einstellungen klicken und einige Einstellungen treffen.

Pfade anpassen

Normalerweise sind die Defaults korrekt:

• config_path: /config (Hier liegen deine YAML-Dateien.)
• backup_path: /data/backups (Hier speichert Time Machine seine Versionen.)

Zeitplan (Schedule)

Hier kannst du einstellen, wie oft Time Machine automatisch einen Snapshot macht.

• Format: Cron-Syntax oder einfache Intervalle (je nach Version).
• Empfehlung: hourly (stündlich) ist für Bastler gut. Wenn du wenig änderst, reicht daily.

Speichere die Konfiguration ab.

Die Benutzeroberfläche: Ein Rundgang

Wenn du Time Machine öffnest, wirst du von einer aufgeräumten Oberfläche begrüßt. Es ist kein überladenes Design, sondern funktional.

Das Dashboard: Hier siehst du eine Zeitleiste (Timeline) oder eine Liste deiner Backups. Jedes Backup hat einen Zeitstempel.

Die Navigation:

• Backups: Deine Liste an Snapshots.
• Settings: Hier kannst du z.B. einstellen, wie viele Backups behalten werden sollen („Retention Policy“), damit dein Speicher nicht voll läuft. Ein guter Wert ist z.B. „Keep last 50“ oder „Keep last 7 days“.

Wenn du auf einen Eintrag in der Backup-Liste klickst, öffnet sich die Magie: der File Browser. Du siehst hier die Struktur deines /config Ordners zum Zeitpunkt des Backups.

Praxis-Szenarien: Time Machine im Einsatz

Theorie ist gut, Praxis ist besser. Lass uns zwei Szenarien durchspielen, die jedem HA-Nutzer früher oder später begegnen.

Szenario A: Die kaputte Automatisierung

Situation: Du hast an deiner „Gute Nacht“-Automatisierung gebastelt. Du wolltest eine Bedingung hinzufügen. Jetzt löst sie gar nicht mehr aus. Du weißt nicht mehr genau, wie der Code vorher aussah.

Lösung mit Time Machine:

1. Öffne Time Machine in der Seitenleiste.
2. Suche ein Backup von gestern (oder von vor einer Stunde, bevor du angefangen hast).
3. Navigiere im File Browser zu automations.yaml (oder dem Ordner, wo deine Automatisierung liegt).
4. Klicke auf die Datei.
5. Du siehst nun den Diff-View.
   • Links (Rot): Was Time Machine gespeichert hat (die alte, funktionierende Version).
   • Rechts (Grün): Was aktuell auf deinem Server liegt (die kaputte Version).
6. Du erkennst sofort: „Ah! Ich habe beim Einrücken (Indentation) einen Fehler gemacht!“
7. Option A (Manuell): Du gehst zurück in deinen Editor und korrigierst den Fehler.
8. Option B (Restore): Du klickst in Time Machine auf den Button Restore.
9. Time Machine fragt zur Sicherheit nach und überschreibt dann deine kaputte Datei mit der alten Version.
10. Anschließend (wichtig!) musst du in Home Assistant unter „Entwicklerwerkzeuge“ -> „YAML-Konfiguration“ die Automatisierungen neu laden, damit die Änderung aktiv wird. (Manche Versionen von Time Machine bieten dafür sogar direkt einen Button an).

Szenario B: Der „Was habe ich eigentlich geändert?“-Moment

Situation: Dein System läuft irgendwie unrund. Ein Sensor liefert komische Werte. Du bist dir sicher, dass du seit Tagen nichts angefasst hast. Oder doch?

Lösung:

1. Gehe in Time Machine.
2. Vergleiche den aktuellen Zustand („Current“) mit einem Backup von vor 3 Tagen.
3. Time Machine zeigt dir alle Dateien an, die sich unterscheiden.
4. Vielleicht siehst du, dass ein anderes Add-on oder ein Update eine Konfigurationsdatei subtil verändert hat.
5. Diese Transparenz ist Gold wert bei der Fehlersuche.

Deep Dive: Time Machine vs. Version Control (Git)

Im Repository von DiggingForDinos findest du oft auch das Add-on „Home Assistant Version Control“. Viele Nutzer verwechseln die beiden.

Was ist der Unterschied?

Home Assistant Time Machine:

• Speicherort: Lokal auf deinem Gerät.
• Technik: Einfache Dateikopien und Diffs.
• Zielgruppe: Jeder. Benötigt kein Git-Wissen.
• Vorteil: Schnell, visuell, einfache Wiederherstellung per Klick.
• Nachteil: Wenn deine Festplatte stirbt, ist auch die Time Machine tot (da sie auf derselben Platte liegt).

Home Assistant Version Control (Git):

• Speicherort: Lokal + Remote Server (GitHub, Codeberg, GitLab).
• Technik: Git (echte Versionierung).
• Zielgruppe: Fortgeschrittene.
• Vorteil: Offsite Backup! Wenn dein Haus abbrennt, liegt deine Config sicher bei GitHub. Du hast eine perfekte Historie über Jahre.
• Nachteil: Wiederherstellung ist aufwendiger (git pull commands via Terminal), keine schöne „Klick-Bunti“-Restore-Oberfläche für Einzeldateien im gleichen Maße.

Die Profi-Strategie: Installiere beide! Nutze Time Machine für das schnelle „Undo“ beim Basteln. Nutze Version Control, um deine Konfiguration jede Nacht automatisch zu GitHub/Codeberg zu pushen, als ultimatives Desaster-Recovery.

Alternative: Die Standalone Installation (Docker)

Du nutzt kein Home Assistant OS, sondern lässt HA als Docker-Container laufen? Kein Problem. Du kannst Time Machine einfach als weiteren Container danebenstellen.

Du musst sicherstellen, dass der Time Machine Container Zugriff auf den /config Ordner deines Home Assistant Containers hat. Das löst man über Volumes.

Hier ist ein Beispiel für eine docker-compose.yml:

docker run -d \
  -p 54000:54000 \
  -e HOME_ASSISTANT_URL="http://your-ha-instance:8123" \
  -e LONG_LIVED_ACCESS_TOKEN="your-long-lived-access-token" \
  -v /path/to/your/ha/config:/config \
  -v /path/to/your/backups:/media \
  -v ha-time-machine-data:/data \
  --name ha-time-machine \
  ghcr.io/diggingfordinos/homeassistanttimemachine:latest

Hinweis: Da sich Image-Namen und Registry-Pfade bei Community-Projekten oft ändern, prüfe bitte im Codeberg-Repo, ob es ein fertiges Image gibt oder ob du den build: ... Befehl nutzen solltest.

Nach dem Start erreichst du Time Machine unter http://deine-ip:54000.

Häufige Probleme und Lösungen (Troubleshooting)

Das Add-on startet nicht.

• Lösung: Prüfe die Logs. Meistens ist der ha_token falsch kopiert (Leerzeichen am Ende?) oder der Pfad zu /config stimmt nicht.

Ich sehe keine Diffs, die Datei sieht leer aus.

• Lösung: Browser-Cache leeren. Manchmal verschluckt sich das Frontend.

Der „Restore“ Button funktioniert nicht.

• Lösung: Prüfe die Berechtigungen. Wenn du Dateien via Samba oder SSH als root erstellt hast und Home Assistant als user läuft, kann Time Machine die Datei vielleicht nicht überschreiben. Führe im Terminal ein chown aus oder nutze den „Fix Permissions“ Button in vielen HA-Tools.

Das Add-on Repository lässt sich nicht hinzufügen.

• Lösung: Codeberg könnte down sein oder der Link hat sich geändert. Suche nach „DiggingForDinos ha-addons“ auf GitHub, oft gibt es dort einen Mirror.

Umsetzung im YouTube-Video

Fazit

Die Home Assistant Time Machine ist eines dieser Tools, von denen man erst weiß, dass man sie braucht, wenn es zu spät ist. Sie nimmt dem „Basteln“ an Home Assistant den Schrecken.

Der Unterschied zwischen „Oh nein, alles ist kaputt“ und „Kein Problem, ich gehe 10 Minuten zurück“ ist massiv für den WAF (Woman/Wife Acceptance Factor) und deinen eigenen Blutdruck.

Während Git-basierte Lösungen (wie das Version Control Add-on) technisch überlegen sind für Offsite-Backups, gewinnt die Time Machine durch ihre Visualisierung. Zu sehen, was sich geändert hat, ist oft wertvoller als das reine Backup selbst.

Meine Empfehlung: Installiere es heute. Jetzt. Bevor du das nächste Mal an deiner Konfiguration schraubst. Es kostet nichts, verbraucht kaum Ressourcen und rettet dir im Ernstfall das Wochenende.

Happy Automating!

Nützliche Links auf einen Blick

• Repository URL für Add-ons: https://codeberg.org/DiggingForDinos/ha-addons
• Quellcode Time Machine: https://codeberg.org/DiggingForDinos/HomeAssistantTimeMachine
• Offizielle Home Assistant Dokumentation zu Backups: https://www.home-assistant.io/common-tasks/os/#backups

Interesse, aber Zeit oder Kenntnisse fehlen?

Kein Problem. Kontaktieren Sie mich und wir besprechen Ihre Anforderungen. Egal, ob geschäftlich oder privat.