Si PeaNUT sigue detectando tu UPS después de reiniciar ZimaOS, pero la configuración guardada desaparece, el problema suele estar relacionado con la persistencia y no con la conectividad de la UPS. El directorio de configuración debe estar asignado a un almacenamiento persistente de ZimaOS y el contenedor debe poder escribir en ese directorio.
El hilo del foro de marzo de 2026 confirmó una solución para la compilación de PeaNUT instalada en ese momento: asignar una carpeta persistente del host a /app/config. Desde entonces, la documentación actual de PeaNUT ha estandarizado la configuración persistente en /config, por lo que las instalaciones nuevas deben seguir la ruta actual en lugar de copiar ciegamente la ruta antigua del contenedor.
Lo que realmente demostró la solución del foro
El autor original informó que todos los ajustes de PeaNUT desaparecían después de cada reinicio de ZimaOS, aunque Home Assistant seguía recibiendo datos de la UPS. Un miembro de la comunidad inspeccionó el paquete y sugirió cambiar la asignación de volúmenes para montar una carpeta del host ubicada en los datos de aplicaciones de ZimaOS en /app/config. El autor original respondió que esto “solucionó el problema”, lo que convirtió la solución en una corrección verificada para esa versión específica del paquete.
Ese resultado no significa que /app/config sea la ruta correcta para todas las imágenes de PeaNUT actuales. Las rutas de los contenedores forman parte del contrato de la imagen y pueden cambiar entre compilaciones.
En las compilaciones actuales de PeaNUT, usa /config
La documentación actual de Docker de PeaNUT usa /config para los ajustes persistentes. La imagen actual también espera que ese directorio sea escribible por el usuario del servicio, normalmente con UID/GID 1000:1000.
En ZimaOS, asigna un directorio persistente del host, como una carpeta de datos de aplicaciones, a /config. Después, reinicia el contenedor y realiza un cambio menor en la configuración. Reinícialo una vez más y confirma que el cambio se conserve. El mismo principio de persistencia se explica en la guía de migración de datos y rutas de aplicaciones de ZimaOS.
Comprueba los permisos de escritura antes de volver a cambiar las rutas
Si la asignación es correcta, pero la configuración sigue restableciéndose, revisa los registros de PeaNUT en busca de errores de permisos. El código actual de upstream muestra explícitamente una advertencia cuando /config no permite escritura. No des por hecho que añadir variables de entorno no compatibles como PUID o PGID solucionará la imagen; la guía actual de upstream se centra en hacer que el directorio del host sea escribible por el usuario de servicio real del contenedor.
El foro de debates de PeaNUT es útil cuando una imagen actual muestra errores específicos de permisos.
Por qué puede fallar docker exec
El hilo original también mostró que docker exec -it PeaNUT sh fallaba porque esa imagen de PeaNUT no incluía un shell. Esto no demuestra que el contenedor esté averiado. Es posible que las imágenes mínimas omitan deliberadamente sh o bash.
Empieza por los registros del contenedor y la asignación de volúmenes configurada. Para obtener información general sobre los fundamentos de la persistencia de contenedores, la guía introductoria de aplicaciones Docker de ZimaOS explica por qué los datos montados desde el host sobreviven a la recreación y los reinicios del contenedor.
En resumen
La antigua solución de la comunidad era válida para el paquete de PeaNUT utilizado en marzo de 2026, pero las compilaciones actuales de PeaNUT documentan /config como directorio persistente. Usa la ruta del contenedor documentada por la imagen instalada, asegúrate de que la carpeta del host permita escritura y verifica la persistencia mediante un reinicio antes de cambiar cualquier otra cosa.
