Una lista de verificación segura para migrar Immich a un nuevo servidor doméstico

Una migración segura de Immich comienza demostrando 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 conectar en el nuevo host.

En un servidor doméstico, el riesgo de migración suele surgir al mover esas piezas en momentos diferentes o al iniciar el destino con rutas incorrectas. Trata el servidor antiguo como la copia de reversión, congela las escrituras evitables, registra la versión actual y las asignaciones de almacenamiento, y luego mueve un conjunto de datos verificado al nuevo equipo. 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 sobrevivir a un reinicio sin volver a un estado vacío.

Congela el origen y registra el estado conocido como correcto

Comienza en el servidor operativo, no en el nuevo. Registra 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 utilizarás para la validación.

El objetivo de este inventario es evitar que una migración se convierta discretamente 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 disposición lógica del almacenamiento lo más estables posible hasta que la restauración esté validada; los cambios de versión pueden gestionarse después de demostrar que el destino funciona.

Antes de copiar, detén o pausa las nuevas cargas si tu hogar puede tolerarlo. Si no es práctico, define una ventana de cambio y planifica una sincronización final breve. La salida de esta etapa es un mapa escrito del origen que te permita responder dónde están los originales, dónde reside el estado de la base de datos y qué configuración recrea las mismas relaciones.

Captura la base de datos, los recursos 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, pero no las fotos ni los vídeos; por tanto, la copia de seguridad de la base de datos debe viajar junto con el contenido correspondiente de UPLOAD_LOCATION y con 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. Un conjunto completo de copias de seguridad de Immich incluye los recursos cargados, una copia de seguridad compatible de la base de datos y la configuración de implementación, y utiliza pruebas de restauración para demostrar que el conjunto funciona. Mantén esas piezas juntas para que el destino pueda asociarse a un único punto de recuperación.

Verifica el conjunto de migración antes de tocar el destino. Confirma que el volcado de la base de datos no esté vacío, toma como muestra varios archivos originales de la biblioteca copiada y guarda los archivos de Compose y de entorno en la misma carpeta del conjunto de migración o en el mismo conjunto de documentación. Si algún componente no se puede verificar, detente aquí y crea una copia nueva en lugar de compensarlo en el nuevo servidor.

Prepara el nuevo host sin crear estados en conflicto

Crea primero los directorios y montajes del destino, y confirma que el nuevo host detecte los discos o recursos compartidos de red previstos en las rutas exactas que planeas utilizar. Un montaje NAS ausente puede dejar un directorio ordinario vacío, y un contenedor puede inicializarse sin problemas usando esa ruta alternativa.

Instala el entorno de ejecución y recrea la definición de implementación, pero no permitas que una instancia vacía de Immich acumule cargas ni configuración antes de restaurar el estado antiguo. Mantén alineados con el origen las credenciales, el nombre de la base de datos, las variables de almacenamiento y los destinos de los montajes de bibliotecas externas, 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 coherentes las rutas visibles para el contenedor y las expectativas de la base de datos. El destino solo estará listo cuando sus montajes efectivos apunten a las ubicaciones de los datos copiados y puedas explicar cada traducción de rutas antes de iniciar la aplicación completa.

Featured

ZimaCube 2 NAS personal en la nube para el hogar

ZimaCube2

$799.00 - $2,499.00

Buy Now

Restaura el estado y vuelve a conectar todas las rutas de almacenamiento

Restaura la base de datos mediante 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 de base de datos tomados de una guía antigua cuando una instalación más reciente utilice un flujo de restauración diferente.

Durante el cambio, 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 multimedia previstas, no inicializar una biblioteca nueva y obligar a reconstruirla desde cero.

Después del inicio, comprueba el acceso al almacenamiento antes de ejecutar tareas pesadas en segundo plano. Abre varios recursos antiguos de fechas diferentes, verifica que se carguen las miniaturas, confirma un álbum y una persona o resultado de búsqueda que existieran antes de la migración, y asegúrate de que las bibliotecas externas sean legibles si las utilizas. Una pantalla de incorporación nueva o una cronología vacía es una señal para detenerse: vuelve a comprobar las asignaciones de la base de datos y de los montajes antes de escribir un estado nuevo.

Valida la carga de trabajo original antes de retirar el servidor antiguo

El primer inicio de sesión correcto no es el final de una migración. Carga una foto de prueba desechable desde el cliente habitual, confirma que aparezca en el almacenamiento previsto del host y elimínala desde Immich; después, verifica que la biblioteca siga funcionando correctamente. Esto comprueba toda la ruta de escritura, en lugar de demostrar únicamente que los datos antiguos se pueden leer.

Reinicia el nuevo servidor doméstico y repite las comprobaciones importantes para tu hogar: inicio de sesión desde el navegador, conexión de copia de seguridad móvil, varias fotos antiguas, búsqueda, un vídeo representativo, colas de tareas y acceso remoto si forma parte de la configuración habitual. La migración solo estará completa cuando el mismo estado sobreviva al reinicio del host y los montajes de almacenamiento estén disponibles antes de que se inicie Immich.

Mantén el servidor antiguo apagado, pero sin cambios, 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 después de reiniciar o muestra errores de base de datos que no puedes explicar, detén las nuevas cargas y vuelve al origen conocido como correcto mientras comparas el conjunto de migración. Retira el host antiguo solo después de que el destino haya superado el uso normal y una prueba de copia de seguridad nueva.