ZimaOS를 재부팅한 후에도 PeaNUT가 UPS를 계속 검색하지만 저장된 설정이 사라진다면, 문제는 대개 UPS 연결이 아니라 데이터 지속성에 있습니다. 구성 디렉터리를 ZimaOS의 영구 저장소에 매핑하고 컨테이너가 해당 디렉터리에 쓸 수 있어야 합니다.
2026년 3월 포럼 게시글에서는 당시 설치된 PeaNUT 빌드에 대한 한 가지 해결 방법을 확인했습니다. 영구 호스트 폴더를 /app/config에 매핑하는 방법입니다. 이후 현재 PeaNUT 공식 문서에서는 영구 구성을 /config 아래에 저장하는 방식으로 표준화했으므로, 새로 설치할 때는 이전 컨테이너 경로를 그대로 복사하지 말고 현재 경로를 따라야 합니다.
포럼의 해결 방법으로 실제 확인된 내용
원래 게시자는 ZimaOS를 재시작할 때마다 모든 PeaNUT 설정이 사라지지만 Home Assistant에서는 UPS 데이터를 계속 수신한다고 보고했습니다. 한 커뮤니티 회원이 패키지를 확인한 뒤 ZimaOS 앱 데이터 아래의 호스트 폴더를 /app/config에 마운트하도록 볼륨 매핑을 변경하라고 제안했습니다. 원래 게시자는 이것으로 “문제가 해결됐다”고 답했으며, 이는 해당 패키지 버전에 대해 검증된 해결 방법입니다.
이 결과가 오늘날 모든 PeaNUT 이미지에서 /app/config가 올바른 대상이라는 뜻은 아닙니다. 컨테이너 경로는 이미지 계약의 일부이며 빌드에 따라 변경될 수 있습니다.
현재 PeaNUT 빌드에서는 /config를 사용하세요
현재 PeaNUT Docker 문서에서는 영구 설정 경로로 /config를 사용합니다. 현재 이미지에서는 일반적으로 UID/GID 1000:1000인 서비스 사용자가 해당 디렉터리에 쓸 수 있어야 합니다.
ZimaOS에서는 앱 데이터 폴더와 같은 영구 호스트 디렉터리를 /config에 매핑한 다음 컨테이너를 재시작하고 간단한 설정을 변경하세요. 한 번 더 재부팅한 후 변경 사항이 유지되는지 확인하세요. 동일한 지속성 원칙은 ZimaOS 앱 데이터 마이그레이션 가이드에서도 설명합니다.
경로를 다시 변경하기 전에 쓰기 권한을 확인하세요
매핑이 올바른데도 설정이 계속 초기화된다면 PeaNUT 로그에서 권한 오류를 확인하세요. 현재 공식 코드에서는 /config에 쓸 수 없을 때 명시적으로 경고합니다. 지원되지 않는 PUID 또는 PGID 환경 변수를 추가하면 이미지 문제가 해결될 것이라고 단정하지 마세요. 현재 공식 지침은 대신 호스트 디렉터리를 컨테이너의 실제 서비스 사용자가 쓸 수 있도록 설정하는 데 중점을 둡니다.
현재 이미지에서 권한 관련 오류가 발생할 때는 공식 PeaNUT 토론 포럼이 유용합니다.
docker exec가 실패할 수 있는 이유
원래 스레드에서는 해당 PeaNUT 이미지에 셸이 포함되어 있지 않아 docker exec -it PeaNUT sh가 실패하는 모습도 나타났습니다. 이것이 컨테이너가 고장 났다는 증거는 아닙니다. 최소 이미지에는 의도적으로 sh 또는 bash가 포함되지 않을 수 있습니다.
먼저 컨테이너 로그와 구성된 볼륨 매핑을 확인하세요. 컨테이너 지속성의 기본 사항은 ZimaOS Docker 앱 입문서에서 확인할 수 있습니다. 이 문서에서는 호스트에 마운트된 데이터가 컨테이너를 다시 만들거나 재시작해도 유지되는 이유를 설명합니다.
결론
기존 커뮤니티 해결 방법은 2026년 3월에 사용된 PeaNUT 패키지에서는 실제로 유효했지만, 현재 PeaNUT 빌드에서는 /config를 영구 디렉터리로 안내합니다. 설치된 이미지에 문서화된 컨테이너 경로를 사용하고, 호스트 폴더에 쓰기 권한을 부여한 다음, 다른 변경을 하기 전에 재부팅하여 설정이 유지되는지 확인하세요.
