Si Immich en ZimaOS sigue en una versión antigua después de editar únicamente la etiqueta de imagen de immich-server, deja de cambiar un contenedor a la vez e identifica primero el paquete o la pila. Immich es una aplicación multiservicio; el servidor, el aprendizaje automático, la base de datos y los componentes de caché deben seguir siendo compatibles, y algunos paquetes de ZimaOS son mantenidos por distintas fuentes de tiendas de aplicaciones.
El hilo de origen muestra por qué una actualización de un solo campo puede fallar: el usuario cambió la imagen del servidor, observó actividad de descarga de red, reinició y Immich siguió mostrando la versión v2.6.1. Otro usuario mostró una configuración funcional de v3.1.0 con imágenes de servicio coincidentes. Por tanto, la guía correcta es «haz una copia de seguridad, identifica la pila, actualiza de forma coherente y verifica», no «escribe un número más reciente en un solo campo».
Paso 1: Identifica qué paquete de Immich instalaste
ZimaOS puede tener paquetes oficiales y paquetes de tiendas de terceros o de la comunidad. Abre la configuración de la aplicación y anota la imagen de cada servicio, no solo immich-server.
Anota también la fuente de la tienda de aplicaciones para saber quién controla los metadatos de actualización.
Paso 2: Haz una copia de seguridad de Immich antes de cualquier actualización importante
Haz una copia de seguridad de la biblioteca de fotos y de la base de datos PostgreSQL. La guía actual de copia de seguridad y restauración de Immich documenta un flujo de trabajo para volcar la base de datos.
No consideres la recreación de un contenedor como una copia de seguridad.
Paso 3: Comprueba las versiones de todos los servicios
La comparación de fuentes indicaba:
- Servidor de Immich;
- Aprendizaje automático de Immich;
- Postgres;
- Valkey/Redis.
Anota las etiquetas completas de las imágenes. Si la tienda de aplicaciones las mantiene como un paquete probado, prioriza su acción de actualización en lugar de adelantar manualmente un componente respecto de los demás.
Paso 4: Usa la actualización de la tienda de aplicaciones cuando esté disponible
La documentación actual de ZimaOS indica que el paquete más reciente de Immich se puede instalar desde la tienda de aplicaciones. Si hay un botón de actualización disponible, úsalo para que la definición de Compose del mantenedor del paquete se actualice conjuntamente.
La guía de Immich de ZimaOS actual es el punto de partida oficial vigente de ZimaOS.
Por qué editar una sola etiqueta puede parecer que descarga algo, pero no actualiza
El administrador de aplicaciones puede descargar una imagen nueva, pero recrear el servicio a partir de los metadatos de la tienda, otro valor YAML guardado o una definición de imagen diferente. Por ello, el contenedor en ejecución puede volver a la etiqueta antigua.
Comprueba la imagen que se está ejecutando con:
docker ps --format '{.Names} {.Image}'No saltes entre versiones principales de Immich a ciegas
Las versiones de Immich pueden incluir cambios en la base de datos/esquema y en los servicios. Lee las notas de lanzamiento/actualización del proyecto original correspondientes a las versiones que vas a atravesar. Actualiza la pila como una unidad en lugar de adivinar combinaciones compatibles.
Si usas un paquete de BigBear u otro paquete de terceros
Una guía independiente de la comunidad de ZimaSpace documenta que cambiar las etiquetas de las imágenes funcionó con algunos paquetes de BigBear, mientras que usuarios posteriores descubrieron que el mismo método no era universal para todos los paquetes. Identifica el origen del paquete antes de aplicar esa solución alternativa.
La guía de actualización de Immich explica ese límite específico del paquete.
Verifica la actualización después de recrear la pila
Comprueba tres lugares:
- las etiquetas de las imágenes de Docker en ejecución;
- la visualización de la versión del servidor de Immich;
- registros del contenedor para detectar errores de migración o compatibilidad.
No elimines la base de datos ni la carpeta de subidas para forzar una actualización
Eliminar volúmenes es un restablecimiento destructivo, no un método de actualización. Conserva la base de datos y la biblioteca de fotos, a menos que tengas una copia de seguridad probada y quieras intencionadamente una instalación nueva.
Preguntas frecuentes
¿Por qué Immich sigue mostrando 2.6.1 después de cambiar la etiqueta del servidor?
Es posible que la aplicación esté recreando la definición de servicio antigua o que la pila no se haya actualizado de forma coherente. Comprueba la imagen que se está ejecutando y el origen del paquete.
¿El aprendizaje automático debe coincidir exactamente con la versión del servidor?
Sigue las versiones probadas en la definición de versión/Compose de Immich que estés implementando. No inventes etiquetas independientes para cada servicio.
¿Puedo actualizar solo immich-server?
Evita usar eso como opción predeterminada. Immich es una pila de varios servicios, y las actualizaciones pueden requerir cambios coordinados.
¿Qué debería respaldar primero?
La base de datos PostgreSQL y tu almacenamiento de medios/subidas. Verifica la copia de seguridad antes de realizar cambios de versión importantes.
