Si la versión de Immich que aparece en ZimaOS es anterior a la versión de Immich publicada y la tienda de aplicaciones no ofrece un botón de actualización, hay formas de actualizar los contenedores manualmente, pero el método correcto depende del paquete de Immich de ZimaOS que hayas instalado. El hilo de la comunidad de IceWhale de diciembre de 2025 confirmó un sencillo cambio de etiqueta de imagen para el paquete BigBear Immich, mientras que respuestas posteriores mostraron que el mismo truco no actualizaba de forma fiable todos los demás paquetes de Immich.
El método de la comunidad consistía en abrir la configuración de la aplicación y cambiar solo las immich-server y immich-machine-learning etiquetas de imagen a la versión de destino, dejando sin cambios las pestañas de la base de datos y Redis. El autor original confirmó que la actualización se realizó sin problemas, y otro usuario de BigBear pasó posteriormente correctamente de v2.3.1 a v2.4.1. Sin embargo, la documentación actual de Immich exige que los administradores lean las notas de la versión, hagan una copia de seguridad de la base de datos y tengan en cuenta los cambios en Compose o en la base de datos antes de actualizar. Esto significa que cambiar manualmente las etiquetas no debe considerarse un botón de actualización universal «siempre seguro».
Primero identifica qué paquete de Immich instalaste
El hilo contiene al menos dos rutas de implementación:
- Immich de BigBear: varios usuarios informaron que editar las etiquetas de imagen en ZimaOS activó correctamente una actualización.
- Paquete original/no BigBear: más tarde, un usuario informó que seguía atascado en v2.1.0 incluso después de intentar cambiar manualmente las versiones del servidor y del aprendizaje automático.
Abre la configuración de la aplicación Immich en ZimaOS y registra los nombres de imagen actuales, las etiquetas, las asignaciones de volúmenes, la imagen de la base de datos y las variables de entorno antes de cambiar nada. No des por hecho que las instrucciones escritas para la definición de BigBear coinciden con otra plantilla de la tienda de aplicaciones.
La actualización de etiquetas de BigBear que funcionó en la comunidad
El procedimiento comunitario que funcionó fue:
- En el panel de ZimaOS, abre el menú de tres puntos de la aplicación Immich.
- Selecciona Settings.
- Abre la pestaña immich-machine-learning.
- Cambia su Tag de imagen a la versión de Immich deseada.
- Abre la pestaña immich-server.
- Establece allí la misma etiqueta de versión.
- Deja sin cambios las pestañas de la base de datos y Redis, a menos que las notas de la versión exijan explícitamente un cambio en la base de datos o el contenedor.
- Guarda la configuración y deja que ZimaOS vuelva a crear o extraiga los contenedores afectados.
En el momento de la respuesta original, la etiqueta de ejemplo era:
v2.3.1Esa versión es histórica. Más tarde, otro usuario actualizó a v2.4.1, y una respuesta de abril de 2026 mencionó v2.7.4. No copies hoy ninguno de esos números de versión antiguos. Elige una versión de destino solo después de comprobar las notas de la versión actuales de Immich y tu ruta de actualización.
Lo que confirmó el autor original
Tras recibir las instrucciones sobre las etiquetas de BigBear, MikeFrizz respondió que el consejo fue muy útil y que la actualización se completó sin problemas. Este es el resultado confirmado más sólido del hilo original.
Esa confirmación respalda el método para el paquete y el contexto de versión utilizados por el autor original. No demuestra que editar manualmente dos etiquetas sea suficiente para cada futura versión principal de Immich ni para cada paquete de ZimaOS.
No des por hecho que la etiqueta «latest» resolverá el problema
Un usuario cambió la etiqueta a latest, pero ZimaOS volvía repetidamente a la versión instalada anteriormente. El hilo contiene después conjeturas, como intentar versión, pero no existe una solución universal confirmada por la fuente basada en esos nombres de etiqueta genéricos.
La documentación actual de Immich utiliza una variable de versión explícita y admite metatags de versiones principales en su propio flujo de trabajo de Docker Compose. Para una aplicación empaquetada de ZimaOS, usa el formato de etiqueta compatible con la definición del paquete y con la imagen ascendente. Evita inventar etiquetas porque una etiqueta parezca plausible.
Haz una copia de seguridad de Immich antes de cambiar de versión
La documentación actual de Immich recomienda explícitamente hacer una copia de seguridad de la base de datos antes de las actualizaciones que puedan implicar migraciones. Tus fotos y vídeos también necesitan una estrategia de copia de seguridad independiente; una copia de seguridad de la base de datos no sustituye a la propia biblioteca multimedia.
Usa la guía de copia de seguridad y restauración de Immich actual antes de realizar un salto de versión manual.
Como mínimo, conserva:
- la copia de seguridad de la base de datos de Immich;
- los datos de la biblioteca multimedia y las cargas;
- la configuración actual de la aplicación ZimaOS y las asignaciones de volúmenes;
- las etiquetas de imagen actuales;
- y cualquier variable de entorno o ubicación de almacenamiento personalizada.
Lee las notas de la versión de Immich antes de cada salto de versión
La documentación actual de actualización de Immich indica que los administradores deben consultar las notas de la versión para conocer los cambios incompatibles antes de actualizar. El proceso normal de Docker Compose ascendente es:
docker compose pull && docker compose up -dpero solo después de que la definición de Compose y las variables de versión sean adecuadas para la versión de destino.
Consulta la guía de actualización de Immich actual.
Esto es importante para ZimaOS porque una aplicación empaquetada puede quedarse desactualizada no solo en las etiquetas de imagen, sino también en su definición equivalente de Compose. Una versión más reciente immich-server la imagen puede requerir cambios en la base de datos, el entorno, las comprobaciones de estado o los volúmenes que un paquete más antiguo no incluye.
Mantén compatibles las versiones del servidor y del aprendizaje automático de Immich
La comunidad cambió específicamente las etiquetas de ambos immich-server y immich-machine-learningLa documentación actual de Immich también advierte que las discrepancias de versión entre el servidor principal y los componentes de aprendizaje automático pueden causar errores o inestabilidad.
No actualices solo uno de los dos porque casualmente mostrara primero una imagen disponible. Trátalos como una única versión coordinada de la aplicación, a menos que la documentación de la versión actual indique explícitamente lo contrario.
No cambies aleatoriamente la etiqueta del contenedor de la base de datos.
El consejo de la comunidad de no tocar la pestaña de la base de datos era sensato para las actualizaciones menores concretas de BigBear que se trataron allí. La capa PostgreSQL de Immich tiene sus propias migraciones y ha cambiado con el tiempo, incluida la migración de extensiones de vectores antiguas a VectorChord.
- No actualices la imagen de la base de datos solo para que todas las etiquetas parezcan numéricamente similares.
- No des por hecho que la imagen de la base de datos nunca debe cambiar; si las notas de la versión actual de Immich requieren una migración de la base de datos o de Compose, sigue esa migración documentada.
¿Qué ocurre si la aplicación original de Immich en ZimaOS permanece en una versión antigua?
Una respuesta de marzo de 2026 indicaba que el usuario no estaba ejecutando la versión de Immich de la tienda de aplicaciones de BigBear y seguía atascado en Immich v2.1.0 incluso después de intentar actualizar manualmente las imágenes de aprendizaje automático y del servidor. El hilo no contiene una solución confirmada para la implementación del paquete original de ese usuario.
Ese es un límite importante: si cambiar manualmente las etiquetas de las imágenes no actualiza la aplicación, deja de repetir la misma operación. Compara la definición actual de los contenedores del paquete con los requisitos actuales de Compose de Immich y considera migrar a un paquete de ZimaOS mantenido solo después de hacer una copia de seguridad y confirmar las rutas de datos.
No desinstales un paquete de Immich que funciona antes de saber dónde están almacenados sus volúmenes de base de datos y multimedia.
Por qué los usuarios de la comunidad sugirieron el paquete Immich de BigBear
La primera respuesta recomendaba la aplicación Immich de BigBear porque normalmente se mantenía más cerca de las versiones originales. Las instrucciones posteriores para editar las etiquetas también se probaron explícitamente en BigBear.
Esto no convierte «reinstalar BigBear» en una ruta segura de migración con un solo clic para una biblioteca existente. Un paquete nuevo puede utilizar nombres de volúmenes, directorios de datos, imágenes de base de datos o variables de entorno diferentes. Considera la migración del paquete como una operación independiente de la actualización de una pila existente.
Ten cuidado con los actualizadores automáticos de contenedores
Una respuesta de la comunidad de abril de 2026 sugirió Tugtainer como alternativa más sencilla a Watchtower para comprobar y actualizar contenedores automáticamente. Esa sugerencia puede resultar práctica para servicios sin estado, pero Immich es una aplicación con varios contenedores y estado persistente, una base de datos PostgreSQL y rutas de actualización documentadas para cambios incompatibles.
En el caso de Immich, reemplazar automáticamente las imágenes sin leer las notas de la versión puede ser arriesgado. La documentación actual de Immich indica explícitamente a los administradores que tengan en cuenta los cambios incompatibles antes de actualizar. Si utilizas un actualizador automático de contenedores, opta por las notificaciones o la aprobación manual para Immich en lugar de actualizar a ciegas cada etiqueta nueva.
Flujo de trabajo más seguro para actualizar Immich en ZimaOS
- Anota si el paquete instalado es BigBear u otra definición de Immich.
- Anota las imágenes o etiquetas actuales del servidor, el aprendizaje automático, la base de datos y Redis.
- Haz una copia de seguridad de la base de datos de Immich y de los archivos multimedia importantes.
- Lee las notas de la versión upstream para cada límite de cambios incompatibles entre tus versiones actual y objetivo.
- Confirma si la versión objetivo requiere cambios en Compose, la base de datos, las variables de entorno o el almacenamiento.
- Para una actualización menor compatible de BigBear, cambia conjuntamente las etiquetas del servidor y del aprendizaje automático, tal como hizo la comunidad.
- Deja sin cambios las imágenes de la base de datos y de Redis, a menos que la ruta de actualización documentada requiera específicamente modificarlas.
- Guarda la configuración de la aplicación y observa los registros del contenedor mientras se inician las imágenes nuevas.
- Verifica la versión de la interfaz web de Immich, las cargas, las miniaturas, el aprendizaje automático y la biblioteca existente antes de eliminar las imágenes antiguas.
- Si el paquete revierte inmediatamente los cambios o permanece en la versión antigua, inspecciona la definición del paquete en lugar de forzar repetidamente las etiquetas.
Qué verificar después de actualizar Immich
- La interfaz web se carga y muestra la versión prevista del servidor.
- La aplicación móvil puede conectarse y es compatible con la versión principal del servidor.
- Las fotos y los vídeos existentes se abren correctamente.
- Las nuevas cargas se completan correctamente.
- Los trabajos de miniaturas y transcodificación se ejecutan.
- Las funciones de aprendizaje automático se inician sin errores de incompatibilidad de versiones.
- El contenedor de PostgreSQL permanece en buen estado.
La documentación actual de Immich señala que la degradación no es una estrategia de recuperación compatible. Una copia de seguridad es más segura que suponer que puedes simplemente volver a cambiar la etiqueta después de una migración de la base de datos.
Preguntas frecuentes sobre la actualización de Immich en ZimaOS
¿Puedo actualizar Immich cambiando las etiquetas de imagen de ZimaOS?
Sí, para algunas combinaciones de paquetes y versiones. El autor original y otro usuario de BigBear confirmaron que cambiar las etiquetas del servidor y del aprendizaje automático funcionó. El hilo también incluye a un usuario ajeno a BigBear para quien el método no solucionó la instalación obsoleta.
¿Qué etiquetas de Immich debo cambiar?
En el método comunitario de BigBear confirmado, immich-server y immich-machine-learning las etiquetas se cambiaron conjuntamente. No copies los ejemplos antiguos v2.3.1, v2.4.1 o v2.7.4 como versiones objetivo actuales.
¿Debería usar latest?
No como solución universal. Un usuario del hilo informó que latest no se mantuvo. Usa el esquema de versiones compatible con tu paquete actual y con las indicaciones actuales de Immich.
¿Puedo ejecutar simplemente docker pull?
Extraer una imagen nueva por sí solo no recrea el contenedor en ejecución ni aplica los cambios de Compose. Immich upstream utiliza docker compose pull && docker compose up -d después de preparar la configuración para la versión objetivo.
¿Deberían Tugtainer o Watchtower actualizar Immich automáticamente?
Las actualizaciones automáticas pueden omitir la revisión de las notas de la versión y de las migraciones que Immich recomienda explícitamente. Para una aplicación con estado y una base de datos, las notificaciones y las actualizaciones manuales controladas son más seguras que una sustitución automática a ciegas.
¿Necesito una copia de seguridad antes de actualizar Immich?
Sí. La documentación actual de Immich sobre actualizaciones y copias de seguridad recomienda proteger la base de datos antes de actualizar, y también debes proteger por separado los archivos multimedia irreemplazables.
