Migrar desde otro servidor Immich

Si ya está usando un servidor Immich autoalojado y desea mover su biblioteca a PixelUnion, puede hacerlo directamente con Immich Go. La migración transfiere sus fotos, vídeos y estructura de álbumes de una instancia Immich a otra, sin necesidad de pasar por su ordenador local.

Lo que necesitará

• Acceso a su servidor Immich existente (debe ser accesible a través de la red)
• Una clave API de su servidor Immich existente
• Una clave API de su cuenta de PixelUnion
• Immich Go descargado en su ordenador

Paso 1: Crear una clave API en el servidor de origen

1. Inicie sesión en su servidor Immich existente
2. Haga clic en su icono de perfil (arriba a la derecha) y vaya a Configuración de cuenta
3. Navegue a Claves API y haga clic en Nueva clave API
4. Asígnele un nombre (p. ej., “Migración”) y asegúrese de que los permisos asset.read y asset.copy estén habilitados
5. Copie la clave generada y guárdela en un lugar seguro

Paso 2: Crear una clave API en PixelUnion

1. Inicie sesión en su dominio de PixelUnion (p. ej., https://sunombre.pixelunion.eu)
2. Haga clic en su icono de perfil (arriba a la derecha) y vaya a Configuración de cuenta
3. Navegue a Claves API y haga clic en Nueva clave API
4. Asígnele un nombre (p. ej., “Migración”) y copie la clave generada

Paso 3: Descargar Immich Go

Vaya a la página de versiones de Immich Go y descargue la versión para su sistema operativo:

• Windows: el archivo .exe
• macOS: el archivo con darwin en el nombre
• Linux: el archivo con linux en el nombre

Extraiga el archivo y coloque el ejecutable immich-go en una carpeta conveniente.

Paso 4: Ejecutar la migración

Abra una terminal, navegue a la carpeta que contiene immich-go y ejecute:

macOS / Linux:

./immich-go upload from-immich \
  --from-server=https://su-servidor-antiguo.com \
  --from-api-key=SU_CLAVE_API_ORIGEN \
  --server=https://sunombre.pixelunion.eu \
  --api-key=SU_CLAVE_API_PIXELUNION

Windows:

.\immich-go.exe upload from-immich --from-server=https://su-servidor-antiguo.com --from-api-key=SU_CLAVE_API_ORIGEN --server=https://sunombre.pixelunion.eu --api-key=SU_CLAVE_API_PIXELUNION

Reemplace los marcadores de posición con sus URLs de servidor y claves API reales.

Immich Go se conecta a ambos servidores, detecta los archivos ya presentes en el destino y transfiere el resto. La estructura de sus álbumes se conserva automáticamente.

Consejos

Acelerar la migración ejecutando múltiples transferencias en paralelo:

./immich-go upload from-immich \
  --from-server=https://su-servidor-antiguo.com \
  --from-api-key=SU_CLAVE_API_ORIGEN \
  --server=https://sunombre.pixelunion.eu \
  --api-key=SU_CLAVE_API_PIXELUNION \
  --concurrent-tasks=4

Migrar solo álbumes específicos:

./immich-go upload from-immich \
  --from-server=https://su-servidor-antiguo.com \
  --from-api-key=SU_CLAVE_API_ORIGEN \
  --server=https://sunombre.pixelunion.eu \
  --api-key=SU_CLAVE_API_PIXELUNION \
  --from-album="Familia" \
  --from-album="Vacaciones"

Reanudar una migración interrumpida: Si el proceso se interrumpe, simplemente ejecute el mismo comando de nuevo. Immich Go registra lo que ya se ha transferido y omite esos archivos.

¿Cuánto tiempo tardará?

La velocidad de migración depende del tamaño de su biblioteca y de su conexión a internet. Como guía aproximada:

• 10 GB: aproximadamente 30-60 minutos
• 100 GB: varias horas, mejor ejecutar durante la noche
• 500 GB o más: planifique un día completo o más

Solución de problemas

Errores de conexión: Verifique que la URL de su servidor de origen sea correcta y accesible desde su ordenador. La URL debe incluir https:// o http://.

Errores de permisos: Verifique que la clave API de su servidor de origen tenga los permisos asset.read y asset.copy habilitados.

Álbumes que no aparecen: Los álbumes se crean durante la transferencia. Si falta un álbum tras completar la migración, vuelva a ejecutar el comando – Immich Go omitirá los archivos ya transferidos y reintentará las partes incompletas.

Si tiene problemas, contacte con nuestro equipo de soporte.