Solución de la comunidad

PhotoPrism no se inicia en ZimaOS: solución para la asignación de originales y almacenamiento

A January 2026 PhotoPrism install failed repeatedly. Logs pointed to a .ppstorage file under the Originals path; simply deleting it did not last, but changing the ZimaOS Originals volume mapping allowed PhotoPrism to start.

La solución final de este hilo no fue «eliminar .ppstorage cada vez». El archivo reaparecía porque la disposición del volumen subyacente seguía siendo incorrecta. El diagnóstico útil provino de los registros, y el cambio duradero consistió en corregir qué directorio del host estaba asignado a la ruta Originals de PhotoPrism.

Pantalla de la aplicación PhotoPrism y registros de una instalación de ZimaOS que no pudo iniciarse
El autor de la publicación original compartió el estado fallido de PhotoPrism antes de corregir las asignaciones de almacenamiento.
Configuración de la aplicación PhotoPrism en ZimaOS que muestra la configuración original del volumen
La configuración de la aplicación se comparó con una plantilla funcional de la comunidad para identificar el problema de la ruta Originals.
Notificación de PhotoPrism que muestra que la aplicación no pudo iniciarse con la disposición de almacenamiento original
La notificación apareció junto con registros que apuntaban al conflicto entre la ruta de almacenamiento y Originals.
Asignación corregida de Originals de PhotoPrism que permitió iniciar la aplicación en ZimaOS
La captura final de la comunidad mostró el cambio en la asignación de Originals que permitió iniciar PhotoPrism.

El mensaje del registro era una pista, no la solución completa

Una respuesta detectó un marcador .ppstorage dentro de /DATA/Gallery y sugirió eliminarlo. El usuario lo hizo, pero PhotoPrism volvió a crear los archivos y siguió fallando. Esto demostró que era necesario corregir la relación entre las rutas, no solo eliminar el archivo.

PhotoPrism separa Originals de Storage

La documentación oficial sobre las carpetas de almacenamiento de PhotoPrism indica que la carpeta Storage contiene la configuración, la caché, las copias de seguridad, las miniaturas y los datos sidecar, y que normalmente no debe configurarse dentro de Originals, salvo que utilice una disposición con nombres ocultos compatible con PhotoPrism. Esta regla del proyecto explica por qué asignar el almacenamiento de la aplicación dentro del árbol de fotos Originals puede causar problemas.

La guía sobre la primera aplicación Docker explica el modelo de ruta del host y ruta del contenedor en ZimaOS, mientras que los requisitos de la App Store de ZimaOS proporcionan el contexto actual a nivel de paquete cuando existe más de una plantilla o pila de dependencias.

Usa los registros antes de cambiar bases de datos o permisos

La guía oficial de solución de problemas de PhotoPrism en Docker recomienda revisar los registros de Docker y menciona específicamente los errores de disco, permisos, rutas y almacenamiento. En este caso, el registro proporcionó información suficiente para evitar reconstruir MariaDB al azar, cambiar puertos o reinstalar todo el sistema operativo.

Qué demostró el cambio funcional de la comunidad

El usuario comparó la plantilla de BigBear con la asignación de la App Store de ZimaOS, cambió el enlace de Originals y PhotoPrism se inició. Esto confirma que la asignación del almacenamiento fue decisiva para esta instalación; no demuestra que todos los paquetes actuales de PhotoPrism utilicen exactamente la misma ruta del host.

En resumen

Si PhotoPrism se instala, pero se cierra de inmediato, lee los registros antes de cambiarlo todo a la vez. En este caso de la comunidad, el síntoma repetido de .ppstorage apuntaba a una relación incorrecta entre Storage y Originals de PhotoPrism. Corregir la asignación del volumen —en lugar de eliminar repetidamente el marcador— permitió iniciar la aplicación.