Solución de la comunidad

Mover el almacenamiento de fotos de Immich a un NAS o a un disco más grande en ZimaOS

A March–April 2025 Immich storage thread where an IceWhale reply pointed users to Docker path mapping and a community member documented the exact host-side volume changes needed to move database, model cache, uploads, and selected media paths to larger storage.

Immich puede consumir una gran cantidad de almacenamiento, por lo que rara vez es ideal dejar sus cargas, base de datos y caché de aprendizaje automático en el disco del sistema de ZimaOS cuando la biblioteca de fotos sigue creciendo.

Este hilo de 2025 documenta una forma manual de mover Immich a otra ubicación de almacenamiento de ZimaOS mediante la edición de las asignaciones de volúmenes del host. El ZimaOS actual también ofrece controles más directos para la ubicación del almacenamiento y la migración, por lo que las capturas manuales deben considerarse principalmente una explicación de cómo encajan las rutas de los contenedores.

Abre la configuración de Immich antes de cambiar los volúmenes

Menú de la aplicación Immich en ZimaOS con la opción Configuración resaltada antes de cambiar los volúmenes de almacenamiento
El flujo de trabajo de la comunidad comenzaba abriendo la configuración de la aplicación Immich instalada, en lugar de mover carpetas a ciegas en Archivos.

Mueve la ruta del host de la base de datos, no la ruta del contenedor

Asignación del volumen de la base de datos de Immich con una ruta del host en /media/Main y la ruta del contenedor de PostgreSQL sin cambios
La configuración funcional de la comunidad modificaba el lado de ZimaOS de la asignación de la base de datos, mientras mantenía intacto el destino del contenedor de PostgreSQL.

Esta distinción entre host y contenedor es fundamental. La aplicación espera rutas específicas dentro de sus contenedores; cambiar ambos lados sin comprender la estructura puede impedir el inicio o hacer que los datos existentes parezcan haber desaparecido.

La caché de aprendizaje automático también puede estar en un almacenamiento más grande

Asignación del volumen de aprendizaje automático de Immich con la caché de modelos almacenada en una ruta /media más grande de ZimaOS
El ejemplo de la comunidad movía la carpeta de la caché de modelos en el host, conservando el destino de caché esperado por el contenedor.

La pestaña immich-server requiere más cuidado

Asignaciones de volúmenes del servidor Immich que muestran la ruta de carga y las carpetas multimedia seleccionadas redirigidas a un almacenamiento en /media
El autor de la fuente destacó que algunas asignaciones de immich-server deben cambiar, mientras que otras deben permanecer exactamente como las espera la aplicación.

La publicación original fue probada por la comunidad, no es una garantía de IceWhale para todas las versiones de Immich. La estructura de Immich ha cambiado considerablemente con el tiempo, así que no reproduzcas esta tabla exacta de volúmenes de 2025 en un paquete más reciente sin comparar la definición actual de la aplicación.

El ZimaOS actual ofrece un flujo de trabajo de almacenamiento más directo

Las instrucciones actuales de Immich para ZimaOS permiten cambiar las ubicaciones de los archivos de almacenamiento y describen cómo mover los datos de Immich a otro disco mediante Migración de datos o una copia manual controlada.

En una instalación actual, empieza por los controles actuales de almacenamiento y migración de Immich antes de reconstruir las asignaciones de volúmenes a partir de una captura de 2025.

Si mueves archivos manualmente, detén Immich primero

Las instrucciones actuales de ZimaOS indican que debes desactivar Immich antes de copiar manualmente sus datos de la galería, actualizar después la ruta correspondiente en el host y reiniciar la aplicación. Detener las escrituras durante el traslado reduce el riesgo de copiar una biblioteca de fotos incoherente.

Preguntas frecuentes sobre el almacenamiento de Immich en ZimaOS

¿Puede Immich almacenar las fotos en un disco más grande en lugar de ZimaOS-HD?

Sí. Tanto el ejemplo de la comunidad de 2025 como el flujo de trabajo actual de Immich en ZimaOS permiten usar otra ubicación de almacenamiento.

¿Debo cambiar la ruta de PostgreSQL dentro del contenedor?

No en el flujo de trabajo de la fuente. Se cambió la ruta de almacenamiento en el host, mientras que la ruta del contenedor de la aplicación permaneció como la ubicación esperada de PostgreSQL.

¿Tengo que seguir exactamente las cuatro pestañas de 2025?

No. Considéralas ejemplos históricos de la estructura de los contenedores. Compáralas con el paquete actual de Immich antes de cambiar nada.

¿Existe ahora una opción de migración integrada?

Las instrucciones actuales de Immich para ZimaOS describen tanto la Migración de datos como un traslado manual controlado de los datos de Immich.