Hoe je kunt controleren of Home Assistant het verwachte configuratiebestand gebruikt

Eva Wong

IceWhale author

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

How to Tell Whether Home Assistant Is Using the Expected Configuration File

Home Assistant gebruikt alleen het verwachte configuratiebestand wanneer de door de runtime gerapporteerde configuratiemap, het gekoppelde hostpad en een gecontroleerde validatietest naar hetzelfde bestand verwijzen.

Deze verwarring komt vaak voor wanneer /config in een container bestaat maar naar een andere map op de host verwijst, of wanneer zowel een oude bind-mount als een nieuw bewerkte kopie configuration.yaml bevatten. Leg eerst het runtimepad vast, trace de mount zonder deze te wijzigen, vergelijk de bestandsidentiteit en tijdstempels en gebruik vervolgens een onschadelijke, omkeerbare markering om te bewijzen uit welke mappenstructuur de actieve instantie leest.

Leg de door de actieve instantie gerapporteerde configuratiemap vast

Open Systeeminformatie vanuit de actieve Home Assistant-instantie en noteer de configuratiemap precies zoals deze wordt weergegeven. Noteer ook het installatietype, de Core-versie, de naam van de container of virtuele machine en het tijdstip van de laatste geslaagde herstart. Zo leg je eerst de runtimeweergave vast voordat hostpaden voor verwarring zorgen.

Uitleg uit de community laat zien waarom /config naar een intern pad kan verwijzen terwijl de bijbehorende map op de host per installatie verschilt. Het nuttige onderscheid is binnen versus buiten de container, niet één universele locatie in het bestandssysteem.

Als de gerapporteerde map het bestand bevat dat je binnen dezelfde runtime-naamruimte hebt bewerkt, ga dan verder met het bewijzen van de bestandsidentiteit. Zo niet, stop dan met het bewerken van die kopie. Als de interface niet beschikbaar is, inspecteer dan het actieve proces of de argumenten en mounts van de container in plaats van te gissen op basis van een oude handleiding.

Traceer het hostpad via de actieve mount

Inspecteer de actieve container of Compose-service en zoek de bron die aan de runtimeconfiguratiemap is gekoppeld. Los relatieve paden op vanuit de daadwerkelijke Compose-projectmap. Maak bij een virtuele machine of HAOS onderscheid tussen het gastpad en de opslag die zichtbaar is voor de hypervisor.

Een issue in het Home Assistant-project documenteerde verwarring waarbij de interface het pad binnen de container toonde, terwijl de daadwerkelijke HAOS-hostgegevens elders stonden. Deze situatie met verschillende host- en containerpaden ondersteunt het traceren van de mount, niet het kopiëren van het exacte pad naar een andere installatie.

Vergelijk de bron van de actieve mount met de map in je editor of bestandsdeling. Als deze verschillen, voeg ze dan nog niet samen. Bewaar beide mappenstructuren, noteer hun wijzigingstijden en groottes en bepaal welke de huidige entiteitenregisters, automatiseringen en recente logactiviteit bevat.

Bewijs de bestandsidentiteit met een veilige, gecontroleerde wijziging

Voer vóór het testen de configuratiecontrole uit binnen dezelfde runtime en maak een back-up van de actieve mappenstructuur. Voeg een onschadelijke, uniek benoemde opmerking of andere omkeerbare markering toe aan het vermoedelijke bestand, sla het op en controleer of de tijdstempel verandert op de locatie waar de runtime-mount naar verwijst.

Gebruik de normale configuratievalidatie en laad indien mogelijk alleen het relevante domein dat opnieuw kan worden geladen. Als een volledige herstart vereist is, herstart dan één keer na de validatie en controleer het logboek op het bestand of de integratie die je hebt gewijzigd. Een herstart zonder bewijs van het pad kan simpelweg opnieuw het verkeerde bestand laden.

Het gerelateerde ZimaSpace-artikel over het gegevenspad van Home Assistant helpt om een zichtbare frontendstatus te onderscheiden van de persistente configuratie- en registerbestanden die deze status hebben veroorzaakt.

-15% OFF

ZimaBoard 2 - Mini-thuisserver voor jouw grote idee

Single board computer zimaboard2

Corrigeer de mount en controleer de persistentie

Als de verkeerde bron is gekoppeld, stop Home Assistant dan, bewaar beide mappen en corrigeer alleen de mountdefinitie waarmee de container opnieuw wordt aangemaakt. Controleer vóór het starten het eigenaarschap en de rechten. Kopieer geen oudere mappenstructuur over recentere gegevens heen tenzij je expliciet hebt bepaald welke gegevens leidend zijn.

Herhaal na het opstarten de controle van het runtimepad, de mount, de tijdstempel, de configuratie en de markering. Een geslaagd resultaat bewijst dat het verwachte bestand wordt gelezen, dat de huidige registers aanwezig blijven en dat dezelfde koppeling een keer opnieuw aanmaken van de container of een herstart van de host overleeft.

Herstel de vorige mount als Home Assistant leeg start, integraties verliest of fouten over rechten meldt. Schakel hulp in met het installatietype, de runtimeconfiguratiemap, de bron en bestemming van de mount en een opgeschoonde mappenlijst wanneer de koppeling onduidelijk blijft; verwijder dubbele mappenstructuren pas nadat het herstel onafhankelijk is gecontroleerd.