Gemenskapslösning

PeaNUT förlorar inställningar efter omstart av ZimaOS: åtgärda beständigheten

A March 2026 ZimaOS user found that PeaNUT still read UPS data after reboot but lost its saved configuration; a forum volume remap fixed that specific installed build.

Om PeaNUT fortfarande hittar din UPS efter en omstart av ZimaOS men de sparade inställningarna försvinner, handlar problemet vanligtvis om beständig lagring snarare än UPS-anslutningen. Konfigurationskatalogen måste mappas till beständig ZimaOS-lagring och containern måste kunna skriva till den katalogen.

Foruminlägget från mars 2026 bekräftade en lösning för den PeaNUT-version som var installerad då: att mappa en beständig värdmapp till /app/config. Den aktuella dokumentationen från PeaNUT uppströms har sedan dess standardiserat beständig konfiguration under /config, så nya installationer bör följa den aktuella sökvägen i stället för att blint kopiera den gamla containersökvägen.

Vad forumlösningen faktiskt bevisade

Den ursprungliga skribenten rapporterade att alla PeaNUT-inställningar försvann efter varje omstart av ZimaOS, trots att Home Assistant fortfarande tog emot UPS-data. En communitymedlem granskade paketet och föreslog att volymmappningen skulle ändras så att en värdmapp under ZimaOS appdata monterades på /app/config. Den ursprungliga skribenten svarade att detta “löste problemet”, vilket gör det till en verifierad lösning för just den paketversionen.

Skärm med PeaNUT-inställningar från den ursprungliga ZimaOS-tråden om beständig lagring
Den ursprungliga tråden visade en PeaNUT-konfiguration som förlorades efter omstart. Källa: IceWhale Community Forum.

Det resultatet betyder inte att /app/config är rätt mål för alla PeaNUT-avbildningar i dag. Containersökvägar är en del av avbildningens kontrakt och kan ändras mellan olika byggen.

För aktuella PeaNUT-byggen: använd /config

Den aktuella PeaNUT-dokumentationen för Docker använder /config för beständiga inställningar. Den aktuella avbildningen förväntar sig också att tjänsteanvändaren kan skriva till den katalogen, normalt med UID/GID 1000:1000.

I ZimaOS mappar du en beständig värdkatalog, till exempel en appdatamapp, till /config. Starta sedan om containern och gör en ofarlig ändring av inställningarna. Starta om en gång till och bekräfta att ändringen finns kvar. Samma princip för beständig lagring beskrivs i guiden om migrering av appdata i ZimaOS.

Kontrollera skrivbehörigheter innan du ändrar sökvägar igen

Om mappningen är korrekt men inställningarna ändå återställs bör du granska PeaNUT-loggarna efter behörighetsfel. Den aktuella koden uppströms varnar uttryckligen när /config inte är skrivbar. Anta inte att det hjälper att lägga till ej stödda miljövariabler som PUID eller PGID; aktuell vägledning uppströms fokuserar i stället på att göra värdkatalogen skrivbar för containerns faktiska tjänsteanvändare.

Det uppströmsbaserade PeaNUT-diskussionsforumet är användbart när en aktuell avbildning ger behörighetsspecifika fel.

Varför docker exec kan misslyckas

Den ursprungliga tråden visade också att docker exec -it PeaNUT sh misslyckades eftersom PeaNUT-avbildningen inte innehöll något skal. Det är inte ett tecken på att containern är trasig. Minimala avbildningar kan medvetet sakna sh eller bash.

Terminal som visar att docker exec-skalet misslyckas för PeaNUT-containern
Containern kunde köras även om ett interaktivt skal inte var tillgängligt. Använd i stället loggar och volymkontroll. Källa: IceWhale Community Forum.

Börja med containerloggarna och den konfigurerade volymmappningen. För en bredare genomgång av grunderna i beständig containerlagring förklarar introduktionen till Docker-appar i ZimaOS varför värdmonterade data överlever när containrar återskapas och startas om.

Sammanfattning

Den gamla communitylösningen fungerade för det PeaNUT-paket som användes i mars 2026, men aktuella PeaNUT-byggen dokumenterar /config som den beständiga katalogen. Använd den containersökväg som dokumenteras av den installerade avbildningen, gör värdmappen skrivbar och verifiera beständigheten med en omstart innan du ändrar något annat.