Jeśli PeaNUT nadal wykrywa zasilacz UPS po ponownym uruchomieniu ZimaOS, ale zapisane ustawienia znikają, problem zwykle dotyczy trwałości danych, a nie połączenia z UPS-em. Katalog konfiguracji musi być zmapowany na trwałą pamięć masową ZimaOS, a kontener musi mieć możliwość zapisu w tym katalogu.
Wątek na forum z marca 2026 roku potwierdził jedno rozwiązanie dla wersji PeaNUT zainstalowanej w tamtym czasie: zmapowanie trwałego folderu hosta na /app/config. Aktualna dokumentacja upstream PeaNUT ustandaryzowała od tego czasu trwałą konfigurację w katalogu /config, dlatego w przypadku nowych instalacji należy korzystać z aktualnej ścieżki, zamiast bezrefleksyjnie kopiować starą ścieżkę kontenera.
Co faktycznie potwierdziło rozwiązanie z forum
Autor oryginalnego posta zgłosił, że wszystkie ustawienia PeaNUT znikały po każdym ponownym uruchomieniu ZimaOS, mimo że Home Assistant nadal otrzymywał dane z UPS-a. Jeden z członków społeczności przeanalizował pakiet i zasugerował zmianę mapowania wolumenu, tak aby folder hosta znajdujący się w danych aplikacji ZimaOS był montowany jako /app/config. Autor oryginalnego posta odpowiedział, że to „zadziałało”, co potwierdza, że rozwiązanie było skuteczne dla konkretnej wersji tego pakietu.
Nie oznacza to, że /app/config jest obecnie właściwym miejscem docelowym dla każdego obrazu PeaNUT. Ścieżki w kontenerze są częścią specyfikacji obrazu i mogą zmieniać się między kolejnymi wersjami.
W przypadku aktualnych wersji PeaNUT używaj ścieżki /config
Aktualna dokumentacja Dockera PeaNUT wskazuje /config jako miejsce przechowywania trwałych ustawień. Aktualny obraz oczekuje również, że katalog ten będzie zapisywalny przez użytkownika usługi, zwykle o UID/GID 1000:1000.
W ZimaOS zmapuj trwały katalog hosta, na przykład folder danych aplikacji, na /config, a następnie uruchom ponownie kontener i wprowadź niewielką, nieistotną zmianę w ustawieniach. Potem jeszcze raz uruchom system ponownie i sprawdź, czy zmiana została zachowana. Ta sama zasada trwałości danych została opisana w instrukcji migracji danych aplikacji ZimaOS.
Przed ponowną zmianą ścieżek sprawdź uprawnienia do zapisu
Jeśli mapowanie jest prawidłowe, ale ustawienia nadal są resetowane, sprawdź logi PeaNUT pod kątem błędów uprawnień. Aktualny kod upstream wyraźnie ostrzega, gdy /config nie jest zapisywalny. Nie zakładaj, że dodanie nieobsługiwanych zmiennych środowiskowych PUID lub PGID naprawi obraz; aktualne zalecenia upstream koncentrują się na zapewnieniu, aby folder hosta był zapisywalny przez rzeczywistego użytkownika usługi w kontenerze.
Upstreamowe forum dyskusyjne PeaNUT jest pomocne, gdy aktualny obraz generuje błędy związane konkretnie z uprawnieniami.
Dlaczego docker exec może się nie powieść
W oryginalnym wątku pokazano również, że polecenie docker exec -it PeaNUT sh kończyło się niepowodzeniem, ponieważ użyty obraz PeaNUT nie zawierał powłoki. Nie świadczy to o uszkodzeniu kontenera. Minimalne obrazy mogą celowo nie zawierać sh ani bash.
Zacznij od logów kontenera i skonfigurowanego mapowania wolumenu. Podstawowe informacje o trwałości danych kontenerów zawiera także wprowadzenie do aplikacji Docker w ZimaOS, które wyjaśnia, dlaczego dane zamontowane z hosta przetrwają ponowne utworzenie i ponowne uruchomienie kontenera.
Podsumowanie
Stare rozwiązanie społeczności rzeczywiście działało w przypadku pakietu PeaNUT używanego w marcu 2026 roku, ale aktualne wersje PeaNUT wskazują /config jako katalog trwałej konfiguracji. Użyj ścieżki kontenera opisanej w dokumentacji zainstalowanego obrazu, zapewnij folderowi hosta uprawnienia do zapisu i sprawdź trwałość danych po ponownym uruchomieniu, zanim zmienisz cokolwiek innego.
