¿Cómo trasladamos nuestra biblioteca de Google Photos a Immich sin perder nada?

Un usuario nuevo de Immich en GitHub publicó los números de su simulación tras un primer intento. Su Takeout llegó en 14 archivos zip, de unos 50 GB, y esperaba more than 9000 photos. immich-go encontró 6233 fotos y 294 vídeos, e informó de 1608 elementos sin metadatos. Nadie en el hilo averiguó por qué; el mantenedor de Immich le remitió al proyecto immich-go.

Para una familia, el camino empieza con un Takeout y una cuenta de Immich por persona, y con una simulación que muestra los recuentos antes de subir nada. immich-go es la herramienta de la comunidad que recomienda la documentación de Immich para los Takeouts, y ni Immich ni DreamHost le dan soporte. Hicimos una importación de prueba con un Takeout inventado en nuestra propia máquina de pruebas, y la sección que sigue a los pasos de importación muestra lo que llegó. Los pasos en sí proceden de las páginas de Immich, de immich-go y de Google, y las cifras de disco son estimaciones basadas en las reglas de dimensionamiento de cada proveedor. Si aún estás eligiendo una aplicación de fotos, nuestra guía sobre Immich, PhotoPrism o Ente las compara primero.

Cuánto disco necesita tu biblioteca

Dimensiona el servidor a partir del total de tu Takeout. La barra de almacenamiento de Google puede mostrar menos de lo que vas a descargar. Las fotos guardadas con Ahorro de almacenamiento antes del 1 de junio de 2021 no cuentan para tu almacenamiento de Google, y la página de transferencia de Google advierte de que las fotos y vídeos transferidos pueden necesitar más espacio del que muestra Google Fotos.

El servidor también necesita espacio además de tus originales. La página de requisitos de Immich indica que las miniaturas y el vídeo transcodificado añaden de media entre un 10 y un 20 % a una biblioteca, y que su base de datos PostgreSQL suele ocupar entre 1 y 3 GB. La lista de comprobación de migración de immich-go recomienda prever unas 1,5 veces el tamaño de origen, lo que deja más margen, así que esta guía se basa en esa regla. La primera columna usa la regla más estricta de 1,5x.

Las bibliotecas familiares pueden crecer mucho. Un comentarista de Hacker News trasladó un Takeout de 890 GB a Immich. Por encima de unos 300 GB, tendrás que dividir la mudanza. La división se hace al importar, porque la página de ayuda de Takeout de Google indica que no se puede exportar un periodo de tiempo concreto. La opción --from-album-name de immich-go importa un álbum con nombre cada vez, así que empieza por los álbumes que más echarías de menos. Si disparaste en pares RAW y JPEG o en ráfagas, los ajustes de immich-go para ahorrar espacio conservan solo el JPEG: --manage-raw-jpeg=KeepJPG para los pares y --manage-burst=StackKeepJPEG para las ráfagas. Guarda todos los zip en un disco en casa para lo que todavía no quepa.

Los 4 GB de RAM de Stack 4 están por debajo del mínimo de 6 GB de Immich salvo que desactives el aprendizaje automático, así que descártalo para esta tarea. Stack 8 tiene los 8 GB de RAM que la página de Immich de DreamHost te aconseja prever, pero sus 2 vCPU son solo el mínimo de Immich. Stack 16 es el primer plan con los 4 núcleos recomendados. Eso importa sobre todo al principio, ya que las preguntas frecuentes de Immich describen la copia inicial como la fase más intensiva due to the number of jobs running. Si más adelante la biblioteca se queda grande para Stack 16, la página de VPS de DreamHost indica que puedes subir a un plan Stack superior y tu entorno se traslada contigo. La misma página aclara que, por ahora, no se puede bajar a un Stack más pequeño.

Un Takeout y una cuenta de Immich por persona

Dale a cada persona su propio Takeout y su propia cuenta de Immich. La guía de instalación de immich-go pide una clave de API por cada cuenta de usuario en la que vayas a importar, así que una familia de cuatro acaba con cuatro cuentas, cuatro claves y cuatro importaciones. Según la página de Immich de DreamHost, cualquier persona a la que invites obtiene una cuenta y usa tu almacenamiento.

Cada enlace de Takeout caduca en unos 7 días, así que conviene seguir a cada persona con la misma lista:

• Takeout solicitado y todas las partes descargadas y contadas
• Cuenta de Immich y clave de API creadas
• Recuentos de la simulación anotados
• Importación real terminada y revisada
• Copia de seguridad del móvil activada

La función de compartir con tu pareja de Google Fotos también puede generar duplicados, y el aviso de abajo explica el ajuste responsable. Cuando termines todas las importaciones, activa la función Partner Sharing de Immich para que cada uno vea las fotos del otro sin una segunda copia.

Mueve la biblioteca paso a paso

Ejecutarás immich-go en el ordenador de casa donde descargaste el Takeout y lo apuntarás a tu servidor, algo que el mantenedor de immich-go califica de «la mejor opción». Además, te ahorras descargar archivos de 50 GB en el servidor, que de todos modos es complicado: un comentarista de Hacker News con unas 14 partes de Takeout de 50 GB cada una no pudo usar wget porque las descargas de Google requieren una sesión iniciada.

Antes de empezar, ten a mano la dirección IP de tu servidor, un acceso SSH a él y un ordenador con espacio para todo el Takeout más los archivos temporales de immich-go. Un usuario cuya importación se detuvo cuando se llenó el disco de ese ordenador la terminó tras apuntar el ajuste IMMICHGO_TEMPDIR a una unidad con 200 GB libres.

Prepara Google Photos y expórtalo

1. Prepara Google Photos antes de exportar

   La lista de elementos que Google no transfiere a otros servicios incluye el contenido de la Carpeta bloqueada, la parte de vídeo de las fotos en movimiento y las Live Photos, y la papelera. Esa lista corresponde a la herramienta de transferencia de Google y no hemos confirmado que un Takeout descargado excluya lo mismo, pero hacer estos arreglos primero puede ahorrarte un segundo Takeout. Saca lo que quieras de la Carpeta bloqueada, guarda las fotos en movimiento y las Live Photos como vídeos, y restaura de la papelera lo que quieras conservar. immich-go deja fuera por defecto las fotos de la papelera, y su opción --include-trashed las incluye. Los comentarios sí se transfieren: la página de descarga de Google indica que van en un archivo JSON aparte.

   Takeout también omite las fotos que otras personas añadieron a tus álbumes compartidos. Una respuesta en las discusiones de Immich en GitHub sugiere guardarlas antes en tu propia cuenta de Google con el botón Guardar del álbum, lo que ocupa almacenamiento de tu cuenta de Google.

2. Solicita un Takeout para cada persona

   En takeout.google.com, desmarca todo. Después, selecciona solo Google Fotos. Elige archivos ZIP y el tamaño de 50 GB. La página de buenas prácticas de immich-go recomienda ambas cosas, y Google indica que el límite de 50 GB reduce la probabilidad de que tu archivo se divida. Prepararlo puede tardar desde unos minutos hasta varios días, y Google advierte de que el archivo puede no incluir fotos o álbumes añadidos o eliminados mientras tanto, así que no toques tus álbumes mientras esperas.

3. Descarga todas las partes y comprueba que no falte ninguna

   El enlace de Google caduca en unos 7 días y cada archivo se puede descargar 5 veces, así que, antes de hacer nada más, descarga todas las partes en un ordenador con espacio para todas. Luego haz una lista y comprueba que la numeración no tiene huecos, ya que la documentación de immich-go cita las descargas incompletas como un error habitual.

   bashCopiar

   ls -la takeout-*.zip

   Mantén todas las partes en formato ZIP. La documentación de immich-go dice que no mezcles ZIP y TGZ en una misma importación. Las descargas tan grandes desde el navegador pueden fallar: el comentarista de las 14 partes encontró las suyas dañadas y lo atribuyó al tamaño de 50 GB y al navegador. Si una parte no se abre, vuelve a descargarla mientras al enlace le queden descargas.

Configura las cuentas y la herramienta

1. Crea una cuenta de Immich y una clave API para cada persona

   Inicia sesión en Immich como administrador con los datos de acceso que crea la instalación de Immich de DreamHost en el primer arranque, y que consultas por SSH desde tu propio ordenador. Crea una cuenta para cada miembro de la familia y, en cada cuenta, abre Account settings > API Keys > New API Key. La guía de instalación de immich-go enumera los permisos que necesita cada clave: asset.read, asset.statistics, asset.update, asset.upload, asset.copy, asset.delete, asset.download, album.create, album.read, albumAsset.create, server.about, stack.create, tag.asset, tag.create y user.read. Guarda cada clave en un lugar seguro.

   Por defecto, immich-go pausa las tareas en segundo plano de Immich durante la subida, y para eso hace falta una clave vinculada al administrador con dos permisos más, job.create y job.read. La clave de un familiar pertenece a su propia cuenta, así que no está vinculada al administrador. La documentación de immich-go no explica qué pasa cuando una clave sin permisos de administrador intenta pausar tareas. Por si acaso, los comandos de abajo desactivan la pausa con --pause-immich-jobs=false. Déjalo así para todos los miembros de la familia. En la importación del propio administrador, con una clave vinculada al administrador que tenga ambos permisos, puedes cambiarlo a true.

2. Descarga immich-go

   Descarga el archivo para tu ordenador desde su página de versiones en GitHub. En un Mac es immich-go_Darwin_arm64.tar.gz para Apple silicon o immich-go_Darwin_x86_64.tar.gz para Intel. Es un único programa, sin Docker ni Node.js que instalar. Descomprímelo y comprueba que funciona:

   bashCopiar

   tar -xzf immich-go*.tar.gz
   ./immich-go --version

   En Windows, descomprime immich-go_Windows_x86_64.zip y ejecuta .\immich-go --version en PowerShell desde esa carpeta. La versión actual, v0.32.0 del 25 de junio de 2026, ofrece full compatibility with Immich V3.0.0, según sus notas de la versión. Su README advierte de que es una versión temprana y te pide que guardes una copia de seguridad de tus archivos.

Ejecuta la importación

1. Haz una prueba en seco y compara los recuentos

   Una simulación reproduce toda la subida sin transferir nada. Usa https:// más la IP de tu servidor como dirección. La instalación de Immich de DreamHost obtiene un certificado de Let’s Encrypt para esa IP, y la página de buenas prácticas de immich-go recomienda usar HTTPS en producción. Sus propios ejemplos usan http:// y el puerto 2283. Las opciones proceden de la referencia de subida de immich-go para v0.32.0:

   bashCopiar

   TZ=America/Chicago ./immich-go upload from-google-photos \
   --dry-run \
   --include-partner=false \
   --pause-immich-jobs=false \
   --server=https://YOUR-SERVER-IP \
   --api-key=YOUR-API-KEY \
   /path/to/takeout-*.zip

   La parte TZ=America/Chicago protege las fechas que proceden de los archivos JSON de Google, que immich-go usa cuando una foto las necesita. El mantenedor de immich-go explica que esas fechas del Takeout llegan en UTC y toman la zona horaria del ordenador que ejecuta immich-go. La opción --time-zone no cambia eso en los Takeouts, y la incidencia seguía abierta el 2 de octubre de 2026.

   TZ no es una opción de immich-go. La documentación de Go indica que, en sistemas Unix, un programa en Go toma su zona horaria local de la variable TZ, así que en macOS y Linux debería fijar la zona solo para ese comando. Pon tu propia zona. No hemos probado la vía de TZ. En Windows, usa PowerShell y, en su lugar, configura el ordenador con la zona horaria de tu familia. Después, quita la parte TZ=America/Chicago, empieza con .\immich-go y termina cada línea con un acento grave en lugar de una barra invertida, como hace el propio ejemplo de PowerShell de immich-go.

   Después de la importación de la primera persona, abre tres fotos cuya hora del día conozcas y compruébalas en Immich antes de importar a nadie más. Las fotos de viajes seguirán mostrando la hora de tu zona, porque, según el mantenedor, immich-go no puede deducir fácilmente una zona horaria a partir del GPS.

   Compara los recuentos de fotos y vídeos del resumen con lo que esperas. Si el recuento de missing associated metadata file es alto, se trata de archivos sin JSON asociado, que --include-unmatched puede incluir más adelante. Si faltan muchos, vuelve a revisar las partes antes de seguir. Empieza con el Takeout de una sola persona.

2. Ejecuta la importación real

   Ejecuta el mismo comando sin --dry-run y añade las opciones que la página de buenas prácticas de immich-go indica para una subida a través de una conexión a internet de velocidad variable. Eso es justo una subida de casa al servidor, y esa misma página usa estos valores para bibliotecas de 100.000 fotos o más:

   bashCopiar

   TZ=America/Chicago ./immich-go upload from-google-photos \
   --include-partner=false \
   --pause-immich-jobs=false \
   --server=https://YOUR-SERVER-IP \
   --api-key=YOUR-API-KEY \
   --concurrent-tasks=4 \
   --client-timeout=60m \
   --on-errors=continue \
   --session-tag \
   /path/to/takeout-*.zip

   La opción --session-tag etiqueta cada subida con la hora de su sesión, para que después puedas ver qué llegó y cuándo. Si la importación se detiene a medias, vuelve a ejecutar el mismo comando: omitirá los archivos que ya estén en el servidor.

   La velocidad de subida de tu conexión de casa marca el ritmo. Como ejemplo del cálculo, subir 200 GB a unos 50 Mbps constantes de subida lleva unas 9 horas. Todos los planes de Immich VPS incluyen ancho de banda sin límite. La página de Immich de DreamHost también promete que no habrá cargos por exceso, según sus condiciones de uso razonable.

Lo que mostró nuestra importación de prueba

Para comprobar estos pasos, hicimos la importación nosotros mismos una vez el 22 de octubre de 2026: immich-go v0.32.0 a Immich v3.3.5, en una máquina virtual de prueba con 2 vCPU y 8 GB de memoria, la misma configuración que Stack 8. El Takeout lo generamos nosotros, con 300 fotos de prueba en dos partes ZIP organizadas como la exportación actual de Google, incluidos archivos JSON con fechas y ubicaciones. Dos álbumes contenían 45 copias de fotos que ya estaban en las carpetas por año. La máquina virtual se ejecutaba en un Mac arm64, así que es nuestra máquina de pruebas, no un servidor de DreamHost.

La subida tardó segundos a través de una conexión dentro del mismo Mac, así que no te dice nada sobre la subida desde tu casa. Lo que consumió tiempo y memoria fue el procesamiento posterior de Immich: unos 6 GB en el pico para solo 300 fotos, en una máquina con 8 GB. Por eso preferimos empezar una biblioteca familiar real en Stack 16 y no en Stack 8, aunque no medimos una biblioteca grande y el pico no se puede extrapolar a partir de 300 fotos. Las miniaturas y las vistas previas añadieron alrededor de un 38 % sobre los originales en esta prueba (169 MB sobre 443 MB), pero las fotos generadas no son archivos reales de cámara, así que la tabla de disco sigue basándose en las reglas de los desarrolladores.

Lo que no pudimos probar: un Google Takeout real, caras reales, vídeos, fotos HEIC o Live Photos, varias cuentas familiares, la simulación y el ajuste TZ. Lo ejecutamos una sola vez.

Comprueba el resultado y termina el traslado

1. Comprueba qué se ha importado

   La lista de comprobación posterior a la migración de immich-go te pide comparar los recuentos entre Google e Immich, revisar una muestra aleatoria y confirmar que las fechas, las ubicaciones y los álbumes han llegado bien. Si una foto no tiene GPS propio pero su álbum tiene una ubicación, la herramienta le aplica la ubicación del álbum.

   Si faltan muchos archivos y están todas las partes, vuelve a ejecutarlo con --include-unmatched, que importa los archivos que no tienen un JSON asociado. Esos llegan con menos metadatos, así que hazlo al final. La plantilla de almacenamiento de Immich está desactivada por defecto. Si la has activado y los archivos acaban en carpetas con la fecha equivocada, las preguntas frecuentes de Immich indican que vuelvas a ejecutar la tarea de migración de almacenamiento. Solo se ejecuta automáticamente una vez por elemento tras la subida.

2. Busca lo que se haya escapado en la preparación

   Busca los elementos de Prepara Google Fotos antes de exportar, como los vídeos de las fotos con movimiento y todo lo que hayas sacado de la Carpeta bloqueada. Si falta algo, pide un Takeout nuevo y vuelve a ejecutar la importación, que omite lo que ya está en el servidor. No borres nada de Google Fotos hasta que los recuentos coincidan.

3. Activa la copia de seguridad del móvil

   Instala la app de Immich en cada móvil, inicia sesión con la cuenta de esa persona y elige los álbumes que quieres copiar. La documentación de copia de seguridad móvil de Immich explica que la app calcula una suma de comprobación de cada archivo y omite los que ya están en el servidor, incluidos los subidos desde la línea de comandos. Por defecto, solo sube por wifi. Una foto del móvil que se diferencie de su copia del Takeout aunque sea en un byte se volverá a subir, así que busca duplicados después de la primera sincronización.

Haz una copia de seguridad antes de borrar nada de Google

Una vez terminada la mudanza, las copias de seguridad de las fotos son cosa tuya, y nuestra guía sobre cómo hacer copias de seguridad de Immich explica cómo hacerlo. Nuestro análisis sobre autoalojar en 2026 cubre el resto de lo que implica gestionar tu propio servidor. Immich hace una copia de seguridad de la base de datos cada día a las 2:00 y conserva las 14 últimas. Su documentación de copias de seguridad indica que esas copias solo contienen metadatos, nunca fotos ni vídeos. DreamHost tampoco hace copias de seguridad de tus fotos, y el asistente immich-backup del servidor vuelca la base de datos y te recuerda que copies tú mismo la carpeta de la biblioteca fuera del servidor.

Haz una segunda copia en otro sitio que no sea el servidor antes de borrar nada de Google. Immich recomienda una estrategia de copias 3-2-1, que la documentación de immich-go detalla así: tres copias, en dos tipos de soporte, con una fuera de casa. Su lista de comprobación termina archivando los archivos originales del Takeout, así que un disco de repuesto con los ZIP es un buen comienzo para esa segunda copia.

Preguntas frecuentes sobre pasar de Google Photos a Immich