---
title: "Migrar desde otro servidor Immich"
description: "Cómo transferir fotos, vídeos y álbumes desde una instancia de Immich autoalojada a PixelUnion con Immich Go"
url: "https://pixelunion.eu/es/help/migrating/migrate-immich/"
weight: 6
---


Si ya está usando un servidor Immich autoalojado y desea mover su biblioteca a PixelUnion, puede hacerlo directamente con [Immich Go](https://github.com/simulot/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](https://github.com/simulot/immich-go/releases/latest) 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](https://github.com/simulot/immich-go/releases/latest) 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](/support/).