So erkennen Sie, ob Home Assistant die erwartete Konfigurationsdatei verwendet

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.

Home Assistant verwendet nur dann die erwartete Konfigurationsdatei, wenn das von der Laufzeit gemeldete Konfigurationsverzeichnis, der eingebundene Hostpfad und ein kontrollierter Validierungstest alle auf dieselbe Datei verweisen.

Diese Verwirrung ist häufig, wenn /config innerhalb eines Containers existiert, aber einem anderen Verzeichnis auf dem Host zugeordnet ist, oder wenn sowohl ein alter Bind-Mount als auch eine neu bearbeitete Kopie die Datei configuration.yaml enthalten. Notiere zuerst den Laufzeitpfad, verfolge seinen Mount ohne Änderungen nach, vergleiche Dateikennung und Zeitstempel und verwende dann eine harmlose, rückgängig zu machende Markierung, um nachzuweisen, welchen Verzeichnisbaum die laufende Instanz einliest.

Das von der laufenden Instanz angezeigte Konfigurationsverzeichnis notieren

Öffne die Systeminformationen in der laufenden Home-Assistant-Instanz und notiere das dort genau angezeigte Konfigurationsverzeichnis. Notiere außerdem den Installationstyp, die Core-Version, den Namen des Containers oder der VM sowie den Zeitpunkt des letzten erfolgreichen Neustarts. So wird zunächst die Laufzeitansicht festgehalten, bevor die Hostpfade die Sache komplizierter machen.

Erklärungen aus der Community zeigen, warum /config auf einen internen Pfad verweisen kann, während das entsprechende Hostverzeichnis je nach Installation unterschiedlich ist. Entscheidend ist die Unterscheidung zwischen innerhalb und außerhalb des Containers, nicht ein universeller Speicherort im Dateisystem.

Wenn das gemeldete Verzeichnis die Datei enthält, die du im selben Laufzeit-Namensraum bearbeitet hast, fahre mit dem Dateinachweis fort. Falls nicht, bearbeite diese Kopie nicht weiter. Ist die Benutzeroberfläche nicht verfügbar, prüfe den laufenden Prozess oder die Argumente und Mounts des Containers, statt anhand eines alten Tutorials zu raten.

Den Hostpfad über den aktiven Mount nachverfolgen

Prüfe den laufenden Container oder den Compose-Dienst und ermittle, welcher Quellpfad dem Konfigurationsverzeichnis zur Laufzeit zugeordnet ist. Löse relative Pfade ausgehend vom tatsächlichen Compose-Projektverzeichnis auf. Unterscheide bei einer VM- oder HAOS-Installation zwischen dem Gastpfad und dem für den Hypervisor sichtbaren Speicher.

In einem Home-Assistant-Projekt wurde dokumentiert, dass es zu Verwirrung kam, weil die Benutzeroberfläche den Pfad innerhalb des Containers anzeigte, während die tatsächlichen HAOS-Hostdaten an einem anderen Ort lagen. Dieser Fall mit Host- und Containerpfad spricht dafür, den Mount nachzuverfolgen, statt den exakten Pfad auf eine andere Installation zu übertragen.

Die aktive Einbindungsquelle mit dem Verzeichnis in Ihrem Editor oder Ihrer Dateifreigabe vergleichen. Falls sie nicht übereinstimmen, die Verzeichnisse noch nicht zusammenführen. Beide Verzeichnisbäume sichern, Änderungszeiten und Größen notieren und ermitteln, welcher die aktuelle Entity-Registry, Automatisierungen und jüngste Protokollaktivitäten enthält.

Dateiidentität mit einer sicheren, kontrollierten Änderung nachweisen

Vor dem Test die Konfigurationsprüfung in derselben Laufzeitumgebung ausführen und eine Sicherung des aktiven Verzeichnisbaums erstellen. Einen harmlosen, eindeutig benannten Kommentar oder einen anderen rückgängig zu machenden Marker in die verdächtige Datei einfügen, speichern und bestätigen, dass sich der Zeitstempel am Ziel der Laufzeiteinbindung ändert.

Den üblichen Weg zur Konfigurationsvalidierung verwenden und anschließend möglichst nur die betreffende neu ladbare Domäne neu laden. Falls ein vollständiger Neustart erforderlich ist, nach der Validierung einmal neu starten und das Protokoll auf die geänderte Datei oder Integration prüfen. Ein Neustart ohne Nachweis des Pfads kann einfach erneut die falsche Datei laden.

Der zugehörige ZimaSpace-Artikel zum Datenpfad von Home Assistant hilft dabei, einen sichtbaren Frontend-Zustand von den persistenten Konfigurations- und Registry-Dateien zu unterscheiden, die ihn hervorgebracht haben.

Single board computer zimaboard2

Einbindung korrigieren und Persistenz überprüfen

Wenn die falsche Quelle eingebunden ist, Home Assistant stoppen, beide Verzeichnisse sichern und nur die Einbindungsdefinition korrigieren, durch die der Container neu erstellt wird. Eigentümer und Berechtigungen vor dem Start überprüfen. Einen älteren Verzeichnisbaum nicht über einen neueren Datenbestand kopieren, es sei denn, Sie haben ausdrücklich festgelegt, welche Daten Vorrang haben.

Nach dem Start Laufzeitpfad, Einbindung, Zeitstempel, Konfigurationsprüfung und Markertest wiederholen. Ein erfolgreiches Ergebnis beweist, dass die erwartete Datei gelesen wird, die aktuellen Registries vorhanden bleiben und dieselbe Zuordnung eine Neuerstellung des Containers oder einen Neustart des Hosts übersteht.

Zur vorherigen Einbindung zurückkehren, wenn Home Assistant leer startet, Integrationen verliert oder Berechtigungsfehler meldet. Wenn die Zuordnung weiterhin unklar ist, eskalieren und Installationstyp, Laufzeitverzeichnis, Quelle und Ziel der Einbindung sowie eine bereinigte Verzeichnisauflistung angeben; doppelte Verzeichnisbäume erst löschen, wenn die Wiederherstellung unabhängig überprüft wurde.

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.