Warum verliert Home Assistant nach der Neuerstellung des Stacks den Zugriff auf persistente Daten?

Das erneute Erstellen eines Home-Assistant-Docker- oder Compose-Stacks sollte die Konfiguration nicht löschen, wenn dieselben persistenten /config-Daten erneut eingebunden werden. Wenn beim Einrichten wieder der Einstiegsbildschirm erscheint oder Integrationen nach der Neuerstellung zu fehlen scheinen, sollte die erste Annahme sein, dass der neue Container eine andere Speicheransicht sieht – nicht, dass Home Assistant den Haushaltsstatus gelöscht hat.

Prüfen Sie die effektive Einbindung, den Hostpfad, das benannte Volume, versteckte Dateien und Berechtigungen, bevor Sie ein älteres Backup wiederherstellen. Ein falsches leeres Verzeichnis kann genau wie ein Konfigurationsverlust aussehen, während die ursprünglichen Daten an anderer Stelle auf dem Host weiterhin intakt sind.

Überprüfen Sie, was tatsächlich unter /config eingebunden ist

Untersuchen Sie den laufenden Container und bestätigen Sie die Quelle der Einbindung, die auf /config verweist. Vergleichen Sie sie mit der alten Compose-Datei oder dem Bereitstellungsprotokoll, statt sich auf einen vertraut wirkenden Ordnernamen zu verlassen.

Docker-Bind-Mounts ersetzen die Ansicht des Zielverzeichnisses im Container, und die aktuelle Dokumentation zu Bind-Mounts weist darauf hin, dass das Einbinden eines Hostverzeichnisses über einem nicht leeren Containerpfad die dort bereits vorhandenen Dateien verdeckt. Ein leerer oder falscher Quellpfad führt daher dazu, dass Home Assistant ein leeres /config sieht.

Starten Sie nicht den Einrichtungsprozess und beginnen Sie nicht mit dem Erstellen neuer Integrationen, bevor die Einbindung bestätigt ist. Neue Schreibvorgänge im falschen Verzeichnis erschweren die spätere Wiederherstellung.

Unterscheiden Sie Bind-Mounts von benannten Volumes

Ein Compose-Stack kann einen expliziten Hostpfad oder ein von Docker verwaltetes benanntes Volume verwenden. Wenn Sie ein Projekt mit einem anderen Projektnamen, Volumenamen oder Pfad neu erstellen, kann dadurch ein neuer leerer persistenter Speicher entstehen, während das alte Volume weiterhin vorhanden ist.

Ein aktueller Docker-Leitfaden zu Volumes erklärt, dass benannte Volumes Daten unabhängig von einzelnen Containern speichern und nach dem Ersetzen eines Containers erneut eingebunden werden können. Das Entfernen eines Containers unterscheidet sich daher vom Entfernen oder Ersetzen seines persistenten Speichers.

Listen Sie die alten und neuen Volumes auf, untersuchen Sie ihre Einhängepunkte über Docker und vergleichen Sie Erstellungszeitpunkte und Inhalte. Vermeiden Sie Bereinigungsbefehle, bis Sie wissen, welches Volume den maßgeblichen Home-Assistant-Status enthält.

Versteckte Dateien können eine Kopie vollständig erscheinen lassen, obwohl sie es nicht ist

Home Assistant speichert wichtige, über die Benutzeroberfläche verwaltete Zustände in versteckten Pfaden wie .storage. Eine Shell-Kopie mit einem Glob wie * oder ein Dateimanager, der Punktdateien ausblendet, kann YAML-Dateien übertragen, während wichtige Registrierungs- und Integrationsdaten unbemerkt zurückbleiben.

Ein Migrationsfall von Docker zu Compose aus dem Jahr 2025 reproduzierte genau diese Grenze: Bei einem Kopiervorgang wurden versteckte Home-Assistant-Daten ausgelassen oder fehlerhaft verarbeitet, und die Migration stabilisierte sich erst, nachdem der vollständige Konfigurationsbaum einschließlich der Metadaten korrekt kopiert worden war.

Vergleichen Sie Verzeichnislisten, die auch Punktdateien enthalten, und überprüfen Sie Eigentümer, Zeitstempel sowie das Vorhandensein erwarteter versteckter Verzeichnisse, bevor Sie zu dem Schluss kommen, dass die Daten selbst beschädigt sind.

Featured

ZimaCube 2 Persönliche Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Überprüfen Sie die Berechtigungen, bevor Sie die Daten erneut kopieren

Auch das richtige Verzeichnis kann unbrauchbar erscheinen, wenn der neu erstellte Container keine Berechtigung zum Lesen oder Schreiben besitzt. Dies kommt häufig vor, nachdem die Daten auf ein neues Dateisystem verschoben, der Docker-Modus geändert, ein Backup von einem anderen Host wiederhergestellt oder die UID-/GID-Zuordnung geändert wurde.

Ein 2026 überprüfter Leitfaden zur Fehlerbehebung bei Docker Engine grenzt diese Fehler auf den tatsächlichen Hostpfad, die Container-UID/GID, den Zugriff auf übergeordnete Verzeichnisse, den Einbindungsmodus und Sicherheitsgrenzen ein. Eine schreibgeschützte Einbindung oder ein abweichender Eigentümer kann Home Assistant daran hindern, den Status zu aktualisieren, selbst wenn die Dateien sichtbar sind.

Beheben Sie das konkrete Eigentümer- oder Einbindungsproblem, statt den gesamten Konfigurationsbaum für alle Benutzer beschreibbar zu machen.

Erstellen Sie den Stack erst neu, wenn der persistente Pfad bestätigt ist

Verwenden Sie die exakt bekannte Compose-Definition, den Image-Tag, den Netzwerkmodus, die Geräte und die Quelle von /config. Starten Sie Home Assistant und überprüfen Sie, ob die erwarteten Benutzer, Dashboards, Integrationen, Automatisierungen und Helfer wieder vorhanden sind, bevor Sie Migrationen oder neue Konfigurationsänderungen zulassen.

Der Wiederherstellungsablauf für einzelne Container von ZimaSpace folgt derselben Regel: Überprüfen Sie die effektiven Einbindungen und verbinden Sie funktionierende Abhängigkeiten erneut, bevor Sie andere Teile eines Stacks wiederherstellen oder ersetzen.

Wenn die maßgeblichen Daten tatsächlich fehlen, fahren Sie mit der Wiederherstellung aus einem Backup fort. Wenn sie vorhanden sind, der neue Container sie jedoch nicht sehen oder ändern kann, liegt das Problem an der Speicherzuordnung oder der Berechtigungsgrenze – nicht an der Home-Assistant-Konfiguration selbst.