Als PeaNUT je UPS na een herstart van ZimaOS nog steeds detecteert, maar de opgeslagen instellingen verdwijnen, ligt het probleem meestal bij persistentie en niet bij de UPS-verbinding. De configuratiemap moet aan permanente ZimaOS-opslag worden gekoppeld en de container moet naar die map kunnen schrijven.
De forumthread uit maart 2026 bevestigde één oplossing voor de toen geïnstalleerde PeaNUT-build: koppel een permanente map op de host aan /app/config. De huidige upstreamdocumentatie van PeaNUT gebruikt inmiddels standaard /config voor permanente configuratie. Nieuwe installaties moeten daarom het huidige pad gebruiken in plaats van blindweg het oude containerpad over te nemen.
Wat de forumoplossing daadwerkelijk aantoonde
De oorspronkelijke melder rapporteerde dat alle PeaNUT-instellingen na elke herstart van ZimaOS verdwenen, terwijl Home Assistant UPS-gegevens bleef ontvangen. Een communitylid onderzocht het pakket en stelde voor de volumekoppeling te wijzigen, zodat een hostmap onder de ZimaOS-appgegevens aan /app/config werd gekoppeld. De oorspronkelijke melder antwoordde dat dit “de oplossing was”, waarmee het voor die specifieke pakketversie een geverifieerde oplossing werd.
Dat betekent niet dat /app/config tegenwoordig voor elke PeaNUT-image het juiste doelpad is. Containerpaden maken deel uit van het contract van een image en kunnen tussen builds veranderen.
Gebruik voor huidige PeaNUT-builds /config
De huidige Docker-documentatie van PeaNUT gebruikt /config voor permanente instellingen. De huidige image verwacht bovendien dat die map schrijfbaar is voor de servicegebruiker, doorgaans UID/GID 1000:1000.
Koppel in ZimaOS een permanente hostmap, zoals een map met appgegevens, aan /config. Start daarna de container opnieuw op en wijzig een onbelangrijke instelling. Herstart het systeem nogmaals en controleer of de wijziging behouden blijft. Hetzelfde persistentieprincipe wordt behandeld in de handleiding voor het migreren van appgegevens in ZimaOS.
Controleer schrijfrechten voordat je de paden opnieuw wijzigt
Als de koppeling correct is, maar de instellingen nog steeds worden teruggezet, controleer dan de PeaNUT-logs op fouten met betrekking tot rechten. De huidige upstreamcode geeft expliciet een waarschuwing wanneer /config niet schrijfbaar is. Ga er niet van uit dat het toevoegen van niet-ondersteunde omgevingsvariabelen zoals PUID of PGID de image repareert; de huidige upstreaminstructies richten zich in plaats daarvan op het schrijfbaar maken van de hostmap voor de daadwerkelijke servicegebruiker van de container.
Het upstream-discussieforum van PeaNUT is nuttig wanneer een huidige image specifieke fouten met betrekking tot rechten geeft.
Waarom docker exec kan mislukken
In de oorspronkelijke thread bleek ook dat docker exec -it PeaNUT sh mislukte omdat die PeaNUT-image geen shell bevatte. Dat is geen bewijs dat de container defect is. Minimale images bevatten mogelijk bewust geen sh of bash.
Begin met de containerlogs en de geconfigureerde volumekoppeling. Voor algemene basisinformatie over persistentie van containers legt de introductie tot Docker-apps op ZimaOS uit waarom gegevens op de host behouden blijven wanneer containers opnieuw worden aangemaakt of gestart.
Kort samengevat
De oude communityoplossing werkte daadwerkelijk voor het PeaNUT-pakket dat in maart 2026 werd gebruikt, maar de huidige PeaNUT-builds documenteren /config als permanente map. Gebruik het containerpad dat door jouw geïnstalleerde image wordt gedocumenteerd, maak de hostmap schrijfbaar en controleer na een herstart of de gegevens behouden blijven voordat je iets anders wijzigt.
