Si Immich sigue mostrando el espacio libre de la SSD del sistema de ZimaOS incluso después de añadir un HDD más grande, la pregunta importante es qué directorio del host está realmente vinculado al montaje de carga/almacenamiento de Immich. En el hilo de la comunidad de abril de 2026, el usuario original ejecutaba Immich 2.7.4 en una SSD del sistema de 250 GB y quería almacenar las fotos en un HDD de 1 TB. Cambiar repetidamente la ruta después de la instalación provocó contenedores no saludables o fallos de inicio.
El hilo original produjo varios resultados diferentes. Un usuario tuvo éxito después de una reinstalación limpia y de usar un YAML personalizado. El autor original finalmente informó que solo tuvo éxito después de elegir la ruta de almacenamiento del HDD antes de instalar Immich. Una respuesta posterior relacionó algunos fallos de inicio con las comprobaciones de integridad del almacenamiento de Immich. La documentación actual de Immich también ha cambiado desde la versión 2.7.4, por lo que la ruta exacta del contenedor de este paquete histórico de ZimaOS no debe copiarse en todas las implementaciones actuales de Immich.
Qué configuración original de Immich 2.7.4 se utilizó
Las instrucciones de la comunidad mostraban esta asignación histórica:
Host: /DATA/Gallery/immich
Contenedor: /usr/src/app/uploadLa primera recomendación fue cambiar únicamente el lado del host y conservar la ruta del contenedor. Por ejemplo, una unidad secundaria podría exponerse mediante una ruta de host de ZimaOS, mientras Immich sigue viendo el directorio de carga interno esperado.
Por qué cambiar simplemente la ruta de host no funcionó para todos
Varios usuarios intentaron reemplazar la ruta de host predeterminada después de que Immich ya se había inicializado. Algunos recibieron un estado de contenedor no saludable, otros vieron un error de sistema de archivos de solo lectura y otros descubrieron que la aplicación seguía indicando la unidad del sistema.
Esto significa que este hilo no respalda la afirmación universal de que «editar un volumen y reiniciar» siempre funciona. Immich conserva el estado de la base de datos y los marcadores de integridad del almacenamiento, y cambiar un montaje bind después de la inicialización puede hacer que el nuevo directorio sea incoherente con el estado que Immich espera.
El método de trabajo confirmado por el autor original
Después de varios intentos fallidos, Solid volvió el 19 de abril y dijo que el método que funcionaba era realizar una instalación limpia y cambiar la ruta de instalación/almacenamiento al HDD de 1 TB antes de que se inicializara la instalación de Immich.
Un segundo usuario confirmó una reinstalación limpia y una ruta YAML personalizada
Otro participante, scott492010, eliminó la instalación fallida, conservó las fotos existentes, borró el estado obsoleto de AppData/base de datos de Immich, reinstaló la aplicación y luego utilizó el YAML personalizado compartido en el hilo. Confirmó explícitamente que la nueva configuración funcionaba.
No elimines AppData ni la base de datos de Immich a la ligera. Ese procedimiento de la comunidad se utilizó en una instalación dañada/de prueba. Si la biblioteca contiene metadatos, usuarios, álbumes o archivos multimedia subidos importantes, haz una copia de seguridad tanto de la base de datos como del almacenamiento de fotos antes de reconstruirla.
Ruta histórica de ZimaOS: /DATA/.media/...
El hilo probó con rutas de unidades externas como:
/DATA/.media/Elements/Photos
/DATA/.media/Elements/Photos/uploadEstos ejemplos eran específicos de las unidades y de la disposición de rutas de ZimaOS de esa conversación. No copies el nombre Elements ni supongas que todas las unidades aparecen en la misma ruta del host. Usa la ruta real que se muestra en la configuración actual de Archivos/aplicaciones de ZimaOS.
La versión actual de Immich utiliza una disposición de almacenamiento de upstream diferente
La documentación actual de Docker Compose de Immich de upstream usa UPLOAD_LOCATION en el host y lo monta en /data en la plantilla actual de Compose. Esto difiere de la asignación histórica de ZimaOS Immich 2.7.4 a /usr/src/app/upload.
Consulta la documentación actual de Docker Compose de Immich.
Este es un límite entre versiones, no una contradicción. Si usas un paquete de la tienda de aplicaciones de ZimaOS, conserva el destino del contenedor que define el paquete actual. Si administras Compose de upstream por tu cuenta, sigue la plantilla actual de upstream.
Guía actual de Immich para ubicaciones de archivos personalizadas
Immich ahora cuenta con una guía de ubicaciones personalizadas para archivos. Recomienda cambiar deliberadamente las ubicaciones del lado del host y mover los archivos existentes correspondientes para que Immich pueda seguir encontrándolos.
Immich también desaconseja dividir upload/ y library/ en montajes bind independientes en el mismo dispositivo. Para un diseño nuevo, sigue el modelo de almacenamiento actual en lugar de reconstruir línea por línea el YAML de la comunidad de 2026.
Por qué la ausencia de archivos .immich puede impedir el inicio
Una respuesta de julio de 2026 en el hilo identificó errores como:
ENOENT: no existe el archivo o directorio
.../encoded-video/.immichLa documentación sobre la integridad del sistema actual de Immich confirma que los archivos ocultos .immich son marcadores de montaje utilizados para detectar permisos incorrectos o montajes de almacenamiento ausentes o reemplazados.
La respuesta del foro sugería crear manualmente las carpetas y los archivos de marcador esperados. La documentación actual del proyecto es más cautelosa: por lo general, los archivos de marcador no deben crearse ni eliminarse manualmente, salvo en situaciones específicas de recuperación. Si el montaje cambió inesperadamente, corrige primero el montaje. Recrear manualmente un marcador solo es apropiado cuando hayas verificado por qué falta.
No uses chmod 777 como solución de permisos predeterminada
La respuesta final de la comunidad también usó:
sudo chmod -R 777 /DATA/Main-Storage/immichEsto concede a todos los usuarios y procesos locales un amplio acceso de escritura. Puede eliminar una barrera de permisos, pero no es el modelo de permisos permanente recomendado. Identifica el UID/GID y los permisos de almacenamiento esperados por el paquete de Immich instalado.
Mantén la base de datos PostgreSQL en un sistema de archivos adecuado
Mover los recursos fotográficos a un HDD grande no significa que todos los componentes de Immich deban estar allí. Los requisitos actuales de Immich indican que la base de datos PostgreSQL debería estar idealmente en almacenamiento SSD local y requiere un sistema de archivos con semántica normal de propiedad y permisos de Unix; NTFS y exFAT no son compatibles con el directorio de datos de la base de datos.
Consulta los requisitos de instalación de Immich.
Esto significa que una arquitectura razonable puede mantener la base de datos y el estado de la aplicación de Immich en un almacenamiento SSD fiable, mientras coloca la ubicación de carga de fotos y vídeos, mucho más grande, en un disco secundario adecuado.
Haz una copia de seguridad antes de reconstruir o mover datos existentes de Immich
La documentación actual de Immich recomienda proteger tanto la base de datos como los archivos del sistema de archivos. Una copia de seguridad de la base de datos por sí sola no contiene las fotos ni los vídeos originales.
Guía de copia de seguridad y restauración de Immich
Orden de solución de problemas más seguro
- Identifica el paquete o la versión exactos de Immich instalados en ZimaOS.
- Registra la asignación actual de host a contenedor para upload.
- Haz una copia de seguridad de las fotos importantes y de la base de datos de Immich antes de modificar una instalación existente.
- Para una instalación nueva, elige la ruta del host destinada al almacenamiento de gran capacidad antes de la primera inicialización, cuando el paquete de ZimaOS lo permita.
- Conserva la ruta del lado del contenedor definida por ese paquete.
- Si la aplicación deja de estar en buen estado, lee los registros de Immich y busca errores de permisos o de integridad del almacenamiento.
- Verifica que la nueva carpeta del host tenga permisos de escritura para la identidad del contenedor de Immich.
- Si los registros mencionan que falta
.immichmarcadores; verifica el montaje y la estructura de directorios antes de crear archivos manualmente. - Evita
chmod 777como solución permanente.
Preguntas frecuentes sobre el almacenamiento del sistema de Immich
¿Por qué Immich sigue mostrando la capacidad de mi SSD del sistema?
El montaje bind activo de upload todavía podría apuntar al almacenamiento del sistema, o es posible que el montaje modificado no se haya inicializado correctamente. Verifica la asignación real de host a contenedor que utiliza el servidor en ejecución.
¿El autor original lo solucionó?
Sí. Solid informó que una instalación limpia, con la ruta del HDD seleccionada antes de la instalación, funcionó después de que los cambios posteriores a la instalación fallaran.
¿Debo copiar /usr/src/app/upload a una instalación nueva de Immich?
No a ciegas. Esa era la ruta del contenedor en el paquete histórico de Immich 2.7.4 de ZimaOS. El Compose actual de Immich usa /data. Sigue el paquete o la versión que realmente ejecutas.
¿Debo crear manualmente archivos .immich?
Solo después de confirmar por qué faltan. La documentación actual de Immich indica que normalmente estos marcadores no deben crearse ni eliminarse manualmente, salvo en casos específicos de recuperación.
¿Puedo colocar la base de datos en una unidad USB exFAT?
Los requisitos actuales de Immich no admiten exFAT/NTFS para el directorio de datos de PostgreSQL. Mantén la base de datos en un sistema de archivos local adecuado y mueve los archivos de fotos por separado si es necesario.
