Una migración segura de Immich empieza por comprobar qué debe conservarse antes de copiar nada: los archivos de fotos, la base de datos y la configuración de implementación que los vuelve a vincular en el nuevo host.
En un servidor doméstico, el riesgo de la migración suele deberse a trasladar esos elementos en momentos distintos o a iniciar el destino con las rutas incorrectas. Considera el servidor antiguo como la copia de reserva, congela las escrituras evitables, registra la versión actual y las asignaciones de almacenamiento, y luego traslada un único conjunto de datos verificado a la nueva máquina. La siguiente lista de comprobación mantiene el proceso reversible hasta que la nueva instancia pueda iniciar sesión, encontrar la biblioteca original, procesar tareas y superar un reinicio sin volver a un estado vacío.
Congela el origen y registra el estado conocido como correcto
Empieza en el servidor actual, no en el nuevo. Anota la versión de Immich, la definición de Compose o de la tienda de aplicaciones, los valores de entorno que controlan las rutas de la base de datos y del almacenamiento, la ubicación de la biblioteca de fotos, la ubicación de la base de datos y cualquier montaje de bibliotecas externas. Anota también la URL actual del servidor y la cuenta de usuario que usarás para la validación.
El propósito de este inventario es evitar que una migración se convierta silenciosamente en una actualización, un rediseño de rutas y un cambio de red al mismo tiempo. Mantén la versión de la aplicación y la estructura lógica de almacenamiento lo más estables posible hasta que la restauración se complete correctamente; los cambios de versión pueden hacerse después de comprobar que el destino funciona.
Antes de copiar, detén o pausa las nuevas cargas si tu hogar puede permitírselo. Si no resulta práctico, define una ventana de transición y planifica una sincronización final breve. Al terminar esta etapa, debes tener un mapa de origen por escrito que te permita responder dónde están los originales, dónde se encuentra el estado de la base de datos y qué configuración reproduce las mismas relaciones.
Captura la base de datos, los archivos y la configuración como un único conjunto de migración
Trata la base de datos y los archivos multimedia como un único conjunto de recuperación, no como dos copias de seguridad independientes. Las copias de seguridad actuales de la base de datos de Immich contienen metadatos y referencias a archivos, no las fotos ni los vídeos en sí, así que la copia de seguridad de la base de datos debe trasladarse junto con el contenido correspondiente de UPLOAD_LOCATION y cualquier dato de bibliotecas externas que gestiones por separado.
Un conjunto de migración utilizable necesita los recursos, el estado de PostgreSQL y la configuración que los vuelve a conectar. Una copia de seguridad completa de Immich incluye los recursos cargados, una copia de seguridad de la base de datos compatible y la configuración del despliegue; las pruebas de restauración sirven para demostrar que el conjunto funciona. Mantén todos esos elementos juntos para poder asociar el destino a un único punto de recuperación.
Verifica el conjunto de migración antes de modificar el destino. Confirma que el volcado de la base de datos no esté vacío, comprueba varios archivos originales de la biblioteca copiada y guarda los archivos Compose y de entorno en la misma carpeta de migración o en el mismo conjunto de documentación. Si no puedes verificar algún componente, detente aquí y crea una copia nueva en lugar de buscar una solución alternativa en el nuevo servidor.
Prepara el nuevo host sin crear estados en conflicto
Crea primero los directorios y montajes de destino y, después, confirma que el nuevo host detecte los discos o recursos compartidos de red previstos en las rutas exactas que planeas usar. Si falta un montaje NAS, puede quedar un directorio vacío normal, y un contenedor podría inicializarse sin problemas en esa ruta alternativa.
Instala el entorno de ejecución y vuelve a crear la definición de despliegue, pero no permitas que una instancia de Immich vacía acumule archivos cargados o configuración antes de restaurar el estado anterior. Mantén las credenciales, el nombre de la base de datos, las variables de almacenamiento y las rutas de montaje de las bibliotecas externas alineados con el origen, salvo que el plan de migración incluya explícitamente un cambio de ruta controlado.
Si el nuevo servidor requiere rutas diferentes en el host, asígnalas deliberadamente y mantén la coherencia entre las rutas visibles para los contenedores y las expectativas de la base de datos. El destino estará listo solo cuando sus montajes efectivos apunten a las ubicaciones de los datos copiados y puedas explicar cada traducción de rutas antes de iniciar toda la aplicación.
Restaura el estado y vuelve a conectar todas las rutas de almacenamiento
Restaura la base de datos con el procedimiento de recuperación adecuado para la versión de Immich que creó la copia de seguridad y, después, inicia los servicios restantes solo cuando la base de datos esté lista. No improvises comandos destructivos para la base de datos basándote en una guía antigua si una instalación más reciente utiliza un procedimiento de restauración diferente.
Durante la transición, conserva intacta la relación entre la base de datos y el almacenamiento antes de reanudar el uso normal. Una secuencia de migración de Immich probada sigue el mismo principio: la aplicación debe abrirse con el estado restaurado de la base de datos y las rutas de medios previstas, no inicializar una biblioteca nueva y obligar a reconstruirla desde cero.
Tras el inicio, comprueba el acceso al almacenamiento antes de ejecutar tareas pesadas en segundo plano. Abre varios elementos antiguos de distintas fechas, verifica que se carguen las miniaturas, confirma que haya un álbum y una persona o un resultado de búsqueda que existieran antes de la migración, y asegúrate de que las bibliotecas externas se puedan leer, si las usas. Una pantalla de bienvenida inicial o una cronología vacía son señales para detenerse: vuelve a comprobar la base de datos y las asignaciones de montaje antes de escribir datos nuevos.
Valida la carga de trabajo original antes de retirar el servidor antiguo
Un primer inicio de sesión correcto no pone fin a una migración. Sube una foto de prueba prescindible desde el cliente habitual, confirma que aparece en el almacenamiento esperado del host, elimínala desde Immich y verifica que la biblioteca siga funcionando correctamente. Así se comprueba toda la ruta de escritura, en lugar de demostrar únicamente que se pueden leer los datos antiguos.
Reinicia el nuevo servidor doméstico y repite las comprobaciones importantes para tu hogar: inicio de sesión en el navegador, conexión de copia de seguridad móvil, varias fotos antiguas, búsqueda, un video representativo, colas de tareas y acceso remoto, si forma parte de la configuración habitual. La migración solo está completa cuando el mismo estado se mantiene tras reiniciar el host y los volúmenes de almacenamiento se montan antes de que se inicie Immich.
Mantén el servidor antiguo apagado pero sin modificar durante un periodo de reversión, en lugar de borrarlo de inmediato. Si la nueva instancia empieza a escribir en una carpeta vacía inesperada, no puede reproducir la biblioteca antigua tras reiniciarse o muestra errores de base de datos que no puedes explicar, detén las nuevas cargas y vuelve a la fuente conocida y funcional mientras comparas el conjunto migrado. Retira el host antiguo solo después de que el destino haya superado las pruebas de uso normal y una prueba de copia de seguridad reciente.
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...



