Warum verliert Home Assistant nach dem Neuerstellen des Stacks den Zugriff auf persistente Daten?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Das Neuerstellen eines Home-Assistant-Docker- oder Compose-Stacks sollte die Konfiguration nicht löschen, wenn dieselben persistenten /config-Daten erneut eingebunden werden. Wenn nach dem Neuerstellen das Onboarding erscheint oder Integrationen fehlen, sollte zuerst angenommen werden, dass der neue Container eine andere Speicheransicht sieht - nicht, dass Home Assistant den Zustand des Haushalts gelöscht hat.

Überprüfe den aktiven Mount, den Hostpfad, das benannte Volume, versteckte Dateien und Berechtigungen, bevor du ein älteres Backup wiederherstellst. Ein falsches, leeres Verzeichnis kann genau wie ein Konfigurationsverlust aussehen, obwohl die Originaldaten an anderer Stelle auf dem Host intakt sind.

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

Überprüfe den laufenden Container und bestätige die Mount-Quelle, die /config zugeordnet ist. Vergleiche sie mit der alten Compose-Datei oder dem Bereitstellungsprotokoll, statt dich auf einen vertraut wirkenden Ordnernamen zu verlassen.

Docker-Bind-Mounts ersetzen die Sicht des Containers auf das Zielverzeichnis. Die aktuelle Dokumentation zu Bind-Mounts weist darauf hin, dass beim Mounten eines Hostverzeichnisses über einen nicht leeren Containerpfad die dort bereits vorhandenen Dateien verdeckt werden. Ein leerer oder falscher Quellpfad lässt Home Assistant daher ein leeres /config sehen.

Führe das Onboarding nicht aus und beginne nicht mit dem Erstellen neuer Integrationen, bevor der Mount überprüft wurde. Neue Schreibvorgänge im falschen Verzeichnis machen die spätere Wiederherstellung verwirrender.

Bind-Mounts von benannten Volumes unterscheiden

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

Ein aktueller Leitfaden zu Docker-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 ist daher etwas anderes als das Entfernen oder Ersetzen seines persistenten Speichers.

Führe die alten und neuen Volumes auf, überprüfe ihre Mountpoints über Docker und vergleiche Erstellungszeiten und Inhalte. Vermeide Prune-Befehle, bis du weißt, welches Volume den maßgeblichen Home-Assistant-Zustand enthält.

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

Home Assistant speichert wichtige, über die Benutzeroberfläche verwaltete Statusdaten in versteckten Pfaden wie .storage. Beim Kopieren mit einem Shell-Muster wie * oder mit einem Dateimanager, der Punktdateien ausblendet, können YAML-Dateien verschoben werden, während kritische Registrierungs- und Integrationsdaten unbemerkt zurückbleiben.

Ein Migrationsfall von Docker zu Compose aus dem Jahr 2025 bestätigte genau diese Grenze: Bei einem Kopiervorgang fehlte ein Teil des versteckten Home-Assistant-Status oder wurde falsch behandelt; die Migration wurde erst stabil, nachdem die vollständige Konfigurationsstruktur samt Metadaten korrekt kopiert worden war.

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

Berechtigungen prüfen, bevor Sie die Daten erneut kopieren

Das richtige Verzeichnis kann trotzdem unbrauchbar erscheinen, wenn der neu erstellte Container keine Leseberechtigung oder Schreibberechtigung dafür hat. Das kommt häufig vor, wenn die Daten auf ein neues Dateisystem verschoben, der Docker-Modus geändert, sie von einem anderen Host wiederhergestellt oder UID/GID-Zuordnungen geändert werden.

Ein 2026 geprüfter Leitfaden zur Fehlerbehebung bei Docker Engine grenzt diese Fehler auf den tatsächlichen Host-Pfad, die Container-UID/GID, den Zugriff auf übergeordnete Verzeichnisse, den Mount-Modus und Sicherheitsgrenzen ein. Ein schreibgeschützter Mount oder abweichende Eigentümerrechte können verhindern, dass Home Assistant den Status aktualisiert, selbst wenn die Dateien sichtbar sind.

Beheben Sie das gezielte Problem mit den Eigentümerrechten oder dem Mount, statt die gesamte Konfigurationsstruktur für alle beschreibbar zu machen.

Stack erst neu erstellen, wenn der persistente Pfad überprüft wurde

Verwenden Sie exakt die bewährte Compose-Definition, den Image-Tag, den Netzwerkmodus, die Geräte und die Quelle für /config. Starten Sie Home Assistant und prü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: Prüfen Sie die tatsächlichen Mounts und verbinden Sie funktionierende Abhängigkeiten wieder, bevor Sie andere Teile eines Stacks wiederherstellen oder ersetzen.

Wenn die maßgeblichen Daten tatsächlich fehlen, fahren Sie mit der Wiederherstellung aus dem Backup fort. Sind sie jedoch vorhanden, aber für den neuen Container nicht sichtbar oder bearbeitbar, liegt das Problem an der Speichereinbindung oder den Berechtigungen und nicht an der Home-Assistant-Konfiguration selbst.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.