Kennt ihr das? Gestern lief noch alles, heute ist die Automation kaputt, und keiner weiß, wer an der YAML war (Spoiler: ihr selbst). Genau dafür gibt es Home Assistant Version Control: Die App merkt sich jede Änderung an eurer Konfiguration per Git und holt alte Stände mit einem Klick zurück. Mit Version 1.5 läuft das jetzt auch vernünftig auf dem Handy.
🕰️ Was das Projekt macht
Version Control ist ein kostenloses Open-Source-Projekt (MIT-Lizenz) des Entwicklers saihgupr und läuft als App (früher „Add-on“) in Home Assistant oder als eigener Docker-Container. Im Hintergrund steckt ein lokales Git-Repository im /config-Ordner. Jede gespeicherte Änderung an .yaml-Dateien und Lovelace-Dashboards landet automatisch als Version in einer Zeitleiste; mehrere schnelle Edits fasst die App zu einem Schnappschuss zusammen.
In der Zeitleiste seht ihr per Diff, was sich geändert hat (grün dazu, rot weg), und stellt einzelne Dateien oder die komplette Konfiguration auf einen früheren Stand zurück. Gelöschte Automationen und Skripte lassen sich wiederherstellen, und bei Automationen und Skripten lädt die App Home Assistant nach dem Zurücksetzen gleich neu. Wer mag, schiebt das Ganze zusätzlich in ein privates GitHub- oder Gitea-Repository. Die secrets.yaml bleibt dabei standardmäßig draußen, sehr vernünftig.
📱 Neu in Version 1.5
- Handy- und Tablet-Ansicht: neues Layout mit Navigationsleiste unten und großen Tipp-Flächen, gedacht für die Companion-App.
- /addon_configs: Die Konfigurationsdateien eurer Apps werden jetzt ebenfalls versioniert, nicht nur die Home-Assistant-Konfiguration.
- Manueller Modus: Wer sein Git-Repository selbst pflegt, bekommt keine Branches oder Stashes mehr überschrieben; „Backup Now“ nimmt alle geänderten und neuen Dateien mit und hält sich an die
.gitignore. - Cloud-Sync: Die Anmeldung an GitHub und Co. bricht mit neueren Git-Versionen nicht mehr weg, eigene SSH-Remotes bleiben erhalten.
Das Nachfolge-Update 1.5.1 kam nur Stunden später und maskiert Zugangstoken in Git-Remote-Adressen, damit sie nicht mehr im Klartext in den Home-Assistant-Logs landen. Wer Cloud-Sync mit Token nutzt, sollte also direkt auf 1.5.1 gehen. Außerdem wurde der Konfetti-Modus poliert. Ja, den gibt es wirklich. 🎉
🤔 Was heißt das für euch?
Ein Ersatz für richtige Backups ist das nicht, das sagt der Entwickler selbst ausdrücklich. Die eingebauten Backups von Home Assistant sichern das ganze System, Version Control dagegen die einzelnen Dateien mit lesbarer Historie. Beides zusammen ist die entspannte Lösung: Backup für den Totalschaden, Version Control für „was habe ich da gestern geändert?“. Wie ihr Backups automatisch aufs NAS oder in die Cloud schickt, steht in meinem Beitrag Home Assistant Backup & Restore. Und wer schon beim Aufräumen ist, findet mit dem HA Housekeeper verwaiste Entitäten und Altlasten.
Ein Hinweis aus der Anleitung: Liegt in eurem /config schon ein eigener .git-Ordner, sichert ihn vorher, denn die App arbeitet mit dem vorhandenen Repository weiter und committet automatisch hinein. Für selbst gepflegte Repos ist der manuelle Modus gedacht.
⚙️ Installation
Unter Einstellungen → Apps → App Store über die drei Punkte → Repositories die Adresse https://github.com/saihgupr/ha-addons hinzufügen, dann „Home Assistant Version Control“ installieren, starten und über „Web-UI öffnen“ loslegen. Alle Details und die Docker-Variante stehen im GitHub-Repository, die Änderungen im Release-Log. Fragen zur Einrichtung klärt ihr am besten in der simon42 Community.
Quelle: Releases v1.5.0 und v1.5.1 auf GitHub, Ankündigung auf Reddit
🔎 Auf der Suche nach dem passenden Gerät?
