La solución alternativa de la fuente fue práctica para un paquete de Immich de 2025, pero no debería incorporarse sin cambios a un tutorial de actualización actual. Un usuario de la comunidad cambió manualmente las immich-server y immich-machine-learning etiquetas de imagen a v1.134.0. El autor original dijo que finalmente funcionó en su sistema ZimaOS principal, pero no en una máquina virtual de prueba.
Desde entonces, Immich ha pasado a v3 y su modelo de implementación mantenido utiliza una pila completa de Docker Compose junto con un valor IMMICH_VERSION. Actualizar solo una o dos etiquetas de servicio puede crear una pila con versiones mezcladas cuando cambian las suposiciones sobre la base de datos, la caché, el aprendizaje automático o la API.
La fuente de 2025 editó las etiquetas de servicios individuales de Immich
La comunidad indicó al usuario que cambiara tanto el servidor como el aprendizaje automático
CogZog dijo que ambas immich-server y immich-machine-learning debería usar la nueva etiqueta. El usuario confirmó que había cambiado ambas, pero la máquina virtual de prueba aún permanecía en la versión anterior.
La compilación principal de ZimaOS finalmente alcanzó la versión v1.134.0
La fuente no estableció ninguna regla para actualizar manualmente la imagen de la base de datos
beep preguntó si la base de datos también debía trasladarse a una etiqueta más nueva y estable. La respuesta de la comunidad fue esencialmente «si no está roto, no lo arregles». Esa fue una opinión, no una política de migración de Immich.
La versión actual de Immich es la v3, con una ruta completa de actualización de Compose
Immich v3.0.0 se lanzó en julio de 2026. El proyecto original indica que se actualice la pila mantenida estableciendo IMMICH_VERSION=v3 y ejecutar el proceso normal de extracción y recreación de Compose, revisando también las notas sobre cambios incompatibles y migración de la versión 3.
Consulta las indicaciones actuales sobre la versión 3 de Immich.
La recomendación actual del proyecto es usar el paquete completo de Docker Compose
La documentación de instalación actual de Immich indica a los usuarios que descarguen la versión docker-compose.yml y .env, luego establece las ubicaciones y IMMICH_VERSION. La ruta de la base de datos PostgreSQL debe permanecer en un sistema de archivos local compatible, no en un recurso compartido de red.
Usa el modelo actual de Compose de Immich para implementaciones manuales o personalizadas.
Para el paquete de la App Store de ZimaOS, prioriza la ruta de actualización actual de la aplicación
La App Store 2.0 actual de ZimaOS incluye gestión de actualizaciones de aplicaciones instaladas. Si el paquete de la tienda ofrece una actualización de Immich, deja que la definición del paquete actualice toda la pila multiservicio en lugar de editar de forma independiente la etiqueta de un solo servicio.
Haz una copia de seguridad antes de actualizar Immich a una versión principal
Protege tanto la biblioteca de fotos y vídeos como el estado de la base de datos y la aplicación antes de cambiar de versión principal. Un directorio de biblioteca en buen estado por sí solo no basta para reconstruir los álbumes, usuarios, metadatos y el estado de la aplicación.
Evitar crear una pila de Immich con versiones mezcladas
Immich no es un contenedor independiente. La aplicación, el servicio de aprendizaje automático, la base de datos y otros componentes auxiliares se prueban como una topología de lanzamiento coordinada. Actualizar una imagen mientras otra permanece fijada puede provocar incompatibilidades de API, esquema o inicio.
La fuente funcionó solo después de que la pila efectiva del usuario se alineara lo suficiente para ejecutar v1.134.0; esto no demuestra que mezclar etiquetas arbitrariamente sea seguro.
Mantener PostgreSQL en almacenamiento local compatible
Los requisitos actuales de Immich indican que el directorio de datos de PostgreSQL debe usar un sistema de archivos local y no debe estar en un recurso compartido de red. El estado de la base de datos suele ser pequeño en comparación con la biblioteca de fotos, pero es esencial para los usuarios, los álbumes, los metadatos y el estado de la aplicación.
Averigua si instalaste el paquete de ZimaOS o una pila Compose personalizada
Si Immich procede de la tienda de aplicaciones de ZimaOS, usa la ruta de actualización actual de la tienda y revisa los cambios de su paquete. Si importaste tu propio Compose, eres responsable de fijar la versión del proyecto original, .env, la ruta de la base de datos y los pasos de migración.
Mezclar ediciones de la tienda de aplicaciones con una pila del proyecto original mantenida manualmente dificulta las futuras tareas de resolución de problemas.
Realiza una comprobación previa a la actualización principal
- Confirma que existe una copia de seguridad reciente de la biblioteca de fotos.
- Haz una copia de seguridad de la base de datos y del estado de la aplicación.
- Registra la versión actual y las asignaciones de volúmenes.
- Lee las notas sobre cambios incompatibles del proyecto original.
- Asegúrate de que la unidad del sistema/AppData tenga suficiente espacio libre para descargar imágenes y realizar migraciones.
Verifica la versión en ejecución y las tareas después de actualizar
No te detengas en «Guardado completado». Abre la página Acerca de/Sistema de Immich, confirma la versión del servidor en ejecución, comprueba el estado de los contenedores y verifica las cargas, las miniaturas, las tareas de aprendizaje automático y la conectividad de la aplicación móvil.
La propia fuente lo demuestra: editar la etiqueta no significó de inmediato que la instancia en ejecución se hubiera actualizado realmente.
Revertir no siempre consiste simplemente en volver a cambiar la etiqueta
Una vez que una versión principal ha migrado el esquema o el estado de la base de datos, es posible que no se admita degradar una imagen. Usa las indicaciones de migración y reversión del proyecto original, junto con copias de seguridad, en lugar de asumir que una etiqueta anterior es un botón universal para deshacer cambios.
Preguntas frecuentes sobre las actualizaciones de Immich
¿Funcionó el método de etiquetado manual de 2025 para el sistema principal del usuario de la fuente?
Sí, con el tiempo. Su máquina virtual de prueba no se comportó de la misma manera.
¿Los usuarios actuales de Immich deberían actualizar únicamente las etiquetas de immich-server y machine-learning?
No. La versión actual de Immich v3 se mantiene como una pila Compose completa, con orientación sobre versiones y migraciones.
¿IceWhale prometió actualizaciones automatizadas de Immich en la fuente?
No. Zima-Giorgio solo dijo que el equipo debatiría la solicitud.
