Cómo migrar los datos de Immich sin perder usuarios, historial ni configuración

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Migra Immich como una migración del estado de la aplicación, no como una simple copia de carpetas: conserva la base de datos, el árbol multimedia, la configuración, los secretos y las rutas que los conectan.

Una migración puede parecer satisfactoria porque todos los JPEG están en el disco nuevo, aunque falten cuentas, álbumes, personas, elementos compartidos, favoritos o relaciones históricas. Primero, crea un punto de reversión y captura un único estado coherente del origen. Cópialo sin cambiar los identificadores, restáuralo en un destino aislado y realiza el cambio solo cuando los flujos de trabajo del hogar coincidan.

Haz inventario de los elementos que deben migrarse juntos

Enumera la base de datos PostgreSQL, los archivos multimedia cargados, los datos generados que quieras conservar, las definiciones de bibliotecas externas, la configuración de Compose o de la aplicación, los valores del entorno, los secretos, los nombres de red y las asignaciones de almacenamiento actuales. Indica qué elementos son la fuente de verdad y cuáles se pueden regenerar después de la recuperación.

Un debate sobre migraciones de 2026 acerca de cómo conservar a los usuarios de Immich durante una migración refuerza el punto central: el estado de los usuarios y de la biblioteca está vinculado a la base de datos y a las rutas montadas, no a la imagen del contenedor. Trata los comandos de la comunidad como ejemplos y adáptalos a la versión exacta implementada.

Antes de la migración, anota un pequeño conjunto de elementos para verificar: dos usuarios, varios álbumes, favoritos, elementos compartidos, una persona o un resultado de búsqueda, archivos antiguos y recientes, y una ruta de biblioteca externa si la usas. Estos registros conocidos permitirán validar la migración con mucha más solidez que si solo comparas el tamaño total de los archivos.

Crea un punto de recuperación coherente antes de copiar

Pausa las nuevas cargas o programa una ventana de mantenimiento para que el origen deje de cambiar mientras capturas el estado de la migración. Haz una copia de seguridad nativa de la base de datos y protege los archivos multimedia de origen y la configuración. Después de la captura, no toques la instancia original hasta que el destino haya superado la verificación.

La guía de recuperación de ZimaSpace sobre la restauración conjunta de los componentes de la biblioteca de fotos explica por qué los originales, el estado del catálogo y la configuración que define las rutas deben corresponder a un punto de recuperación compatible. Ese es también el criterio para una migración.

No uses el directorio de la base de datos de producción activa como destino de una copia de archivos convencional mientras esté cambiando. Si el tiempo de inactividad debe ser breve, usa un volcado compatible con la base de datos y un método de almacenamiento cuyo orden de captura comprendas. La capacidad de recuperación de una migración depende del punto al que puedas restaurar, no del número de archivos copiados.

Copia los archivos multimedia sin alterar las rutas ni los permisos

Copia el árbol multimedia al destino sin reorganizar las carpetas durante la migración. Conserva la propiedad, los permisos, las marcas de tiempo y las funciones del sistema de archivos de las que dependa tu implementación. Si se supone que la ruta visible desde el contenedor debe permanecer igual, cambia el origen del enlace de montaje en el host y mantén estable la asignación dentro del contenedor.

El flujo de trabajo de migración con rsync actual destaca el modo de archivo, las simulaciones, las transferencias reanudables y el peligro de las opciones de replicación destructiva. Ejecuta una comparación simulada antes de eliminar nada y verifica el destino en lugar de dar por hecho que un comando completado equivale a una migración completa de la aplicación.

Compara las cantidades y los tamaños de los archivos y luego verifica una muestra representativa de sumas de comprobación que incluya fotos antiguas y nuevas, videos y archivos grandes. Si aparecen errores de copia o «archivos desaparecidos» porque el origen cambió, deja de aceptar cargas y repite la pasada diferencial en lugar de eliminar el origen para que el destino parezca limpio.

Restaura la base de datos y la configuración en un destino aislado

Inicia el destino con un nombre de host temporal o en una red aislada para que los clientes móviles no puedan cargar archivos durante la validación. Conecta los archivos multimedia copiados en las rutas de contenedor previstas, restaura la base de datos correspondiente y reproduce el entorno, los secretos, las redes y la configuración del proxy necesarios para esa versión.

Un caso de migración de servidor por etapas documentado en 2026 muestra por qué los operadores prueban el nuevo host antes de retirar el antiguo. Usa informes de este tipo para identificar posibles fallos, pero deja que tus registros conocidos determinen si la migración realmente conservó el estado.

Detente si el destino se abre como una instalación nueva, indica que falta almacenamiento o propone una inicialización destructiva. Estos síntomas suelen significar que la base de datos o los montajes no son los esperados. Corrige primero la ruta o el destino de restauración; no cargues archivos nuevos en una instancia que parece vacía y crees dos historiales en conflicto.

Haz el cambio solo después de verificar los usuarios, el historial y las nuevas escrituras

Inicia sesión con cada usuario de referencia y verifica la pertenencia a álbumes, los favoritos, el uso compartido, el estado de búsqueda o de personas, los archivos originales representativos, las marcas de tiempo y los recuentos previstos de la biblioteca. Luego, carga una foto de prueba nueva y confirma que aparezca, se procese y siga ahí tras reiniciar el contenedor.

Cambia el DNS de producción o el destino del proxy solo después de que la prueba aislada se complete correctamente. Mantén detenida la instancia antigua, pero recuperable, para que ambos sistemas no puedan aceptar escrituras a la vez. Conserva la copia de seguridad de la base de datos previa a la migración y los archivos multimedia de origen hasta que el nuevo host haya completado las copias de seguridad habituales y al menos una prueba de restauración.

Revierte la migración si los recuentos difieren, desaparecen relaciones conocidas, las nuevas cargas se escriben en el disco incorrecto o el destino falla tras reiniciarse. Escala el problema con las versiones de origen y destino, la fecha y hora de la copia de seguridad de la base de datos, los mapas de montaje, los registros de copia, las diferencias de permisos y el primer elemento de verificación que haya fallado.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.