Evita perder la configuración de Immich durante las actualizaciones tratando el archivo de Compose, los valores del entorno, la base de datos, la biblioteca de cargas y las definiciones de montaje de las bibliotecas externas como recursos persistentes independientes que se deben capturar y restaurar en conjunto.
Un contenedor se puede reemplazar; la configuración que lo rodea, no. Una actualización puede parecer borrar Immich cuando un montaje bind relativo se resuelve desde un directorio de proyecto distinto, un cambio en el entorno no llega al contenedor recreado o la nueva pila se inicia con una base de datos vacía. Primero inventaría la implementación activa, guarda copias versionadas fuera del host y verifica una recreación controlada antes del cambio en producción.
Captura la implementación activa antes de cada actualización
Exporta la configuración efectiva de Compose con los secretos ocultos, registra las versiones o los resúmenes criptográficos de las imágenes y copia los archivos de Compose y del entorno en un almacenamiento con control de versiones. Inspecciona los puntos de montaje activos en lugar de asumir que el archivo que tienes abierto en el editor inició los contenedores actuales. El criterio de aprobación es que cada ruta en tiempo de ejecución corresponda a una ubicación de host conocida.
Registra las rutas de las bibliotecas externas, la configuración del proxy inverso, la URL del aprendizaje automático, los valores de conexión de la base de datos, la identidad del usuario y del grupo, los nombres de red y cualquier dispositivo de aceleración de hardware. Si falta alguno de estos elementos, más adelante habrá una diferencia inexplicable tras la actualización.
Las preguntas de la comunidad sobre actualizaciones muestran repetidamente que los operadores pierden de vista qué generación de Compose o estructura del entorno corresponde. La lección útil de un debate sobre la configuración de actualizaciones es conservar la definición funcional actual antes de traducirla.
Haz copias de seguridad por separado de la base de datos, los archivos multimedia y los archivos de implementación
Haz una copia de seguridad nativa de la base de datos y una copia de seguridad o instantánea del sistema de archivos de la biblioteca de cargas y del directorio de implementación. Registra las horas de inicio y finalización, el tamaño de los archivos y las sumas de verificación. Una copia de seguridad que solo contenga YAML de Compose puede reconstruir los contenedores, pero no restaurar las cuentas, los metadatos, los álbumes ni los registros de los archivos multimedia.
Usa una copia de seguridad detenida para establecer el límite de coherencia más sencillo, o coordina un volcado activo de la base de datos y una instantánea del almacenamiento para documentar su relación. Mantén las bibliotecas externas en el inventario aunque Immich no sea el propietario de sus archivos originales, porque las rutas y las reglas de acceso siguen afectando al servicio restaurado.
Un procedimiento de actualización entre versiones principales mantenido por la comunidad recalca que se deben conservar la base de datos, los archivos multimedia, Compose y las variables de entorno. Toma su secuencia como experiencia práctica de operadores y verifica cada paso según la versión que vayas a desplegar.
Prepara la actualización con versiones fijadas
Lee las notas de la versión de cada versión que omitas y actualiza deliberadamente la definición del despliegue guardada. Fija la versión de destino, descárgala sin eliminar las imágenes anteriores y valida la configuración de Compose generada. Las variables desconocidas, los puntos de montaje vacíos o las versiones de servicio mezcladas impiden superar la fase de pruebas.
Si la capacidad lo permite, restaura la copia de seguridad en una pila de prueba aislada, con puertos distintos y sin acceso de escritura a producción. Iníciala con la versión de destino y revisa las migraciones, los usuarios, las rutas de almacenamiento y las tareas en segundo plano. Que el contenedor se inicie correctamente no demuestra por sí solo que esté conectada la biblioteca original.
La guía relacionada de ZimaSpace sobre un NAS autoalojado seguro ayuda a ubicar los archivos del despliegue y las copias de seguridad fuera de los límites de un único host y sus credenciales, que una actualización puede alterar.
Demuestra que la configuración persiste tras volver a crear los contenedores
Antes del cambio, vuelve a crear los contenedores de prueba a partir de los archivos guardados, en lugar de reiniciarlos sin más. Comprueba los usuarios, la configuración del servidor, las plantillas de almacenamiento, las bibliotecas, las tareas, el acceso al proxy y los valores efectivos del entorno. La prueba se supera si la configuración sobrevive al reemplazo porque reside en componentes persistentes documentados.
Tras el cambio a producción, carga un recurso de prueba, realiza una búsqueda, abre un original y crea una nueva copia de seguridad de la base de datos. Reinicia la pila y el host, y repite las comprobaciones. Conserva la versión anterior, la copia de seguridad y la definición del despliegue hasta que la carga de trabajo habitual se mantenga estable durante el periodo de observación.
Si la actualización ya ha comenzado sin datos, detenla antes de que la configuración inicial o las nuevas cargas generen un estado conflictivo. Vuelve a conectar solo una ruta persistente verificada o restaura en un destino limpio. Revierte los cambios si faltan los usuarios o recursos esperados; si la identidad sigue siendo ambigua, escala el caso con una configuración de Compose efectiva depurada, los puntos de montaje, las versiones y las marcas de tiempo de las copias de seguridad.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



