Guía de Immich: tus fotos en tu propio servidor

Google Photos te avisa de que se te acaban los 15 GB gratis y te ofrece pagar todos los meses para siempre. Ese es, casi siempre, el momento en que uno descubre Immich. Yo llegué igual.

Immich es un servidor de fotos y vídeos que corre en tu propia máquina. Subes desde el móvil igual que con Google Photos —copia automática en segundo plano, timeline, álbumes, búsqueda—, pero los archivos se quedan en tu disco, en tu casa, sin cuota mensual y sin que nadie entrene nada con tus recuerdos. Es de los proyectos autoalojados que más rápido enganchan, porque resuelve un problema que todo el mundo tiene.

Aquí va la guía completa: qué es, qué hardware pide de verdad, cómo se instala con Docker paso a paso, y —lo que casi nadie explica bien— cómo hacer una copia de seguridad que sirva para restaurar.

[aff]Hay enlaces de afiliado más abajo: si compras algo desde ellos me llevo una pequeña comisión y a ti no te cuesta ni un céntimo más. En calidad de Afiliado de Amazon, obtengo ingresos por las compras adscritas que cumplen los requisitos aplicables.

Qué es Immich y qué te da

Immich (se pronuncia “emich”, es un juego con “image”) es software libre. Un equipo muy activo lo actualiza casi cada semana, así que da algo de vértigo al principio, pero la instalación base lleva tiempo siendo estable.

Lo que hace, en cristiano:

• Copia automática de la galería del móvil en cuanto entras en la wifi de casa, como la de Google.
• Reconocimiento facial y búsqueda por IA: busca “playa”, “perro” o la cara de tu sobrina y los encuentra. Eso lo hace un contenedor aparte, en tu servidor, sin mandar nada fuera.
• Álbumes compartidos, líneas de tiempo, mapa por geolocalización, usuarios múltiples para toda la familia.
• Apps de iOS y Android decentes de verdad, más una web para el escritorio.

No es un clon pixel a pixel de Google Photos, y conviene saberlo: al ser un proyecto en desarrollo rápido, de vez en cuando una actualización trae cambios que hay que leer antes de aplicar. A cambio, tus fotos son tuyas y el almacenamiento solo depende del disco que le pongas.

Qué hardware necesita de verdad

Buenas noticias: menos del que la gente teme. Immich no es Plex transcodificando 4K. Según la documentación oficial, el mínimo son 2 núcleos de CPU y 6 GB de RAM, con 8 GB para ir cómodo, sobre todo mientras suben muchas fotos a la vez. Con 4 GB también arranca, pero desactivando las funciones de IA.

Traducido a equipos: cualquier mini PC de gama baja con 16 GB de RAM va sobrado para una biblioteca doméstica. En uno de los equipos del banco de pruebas, un Intel N100 con 16 GB, Immich corre con reconocimiento facial y su motor de IA junto a otros servicios sin inmutarse; el reconocimiento tira de CPU en ráfagas cuando procesa fotos nuevas, y luego se calma. Un detalle técnico que conviene comprobar: desde la versión 2.6, el contenedor de IA en equipos x86 pide un nivel de microarquitectura x86-64-v2, que soporta prácticamente cualquier CPU de 2012 en adelante. Un N100 o un N150 lo cumplen de sobra.

Si tu servidor es una Raspberry Pi 5 (que es ARM), Immich también corre; ahí sí conviene la de 8 GB y no exprimir la IA con bibliotecas enormes. Lo tratamos en la guía de la Raspberry Pi 5 como servidor casero.

El mini PC con el que yo empezaría para esto —y para el resto del homelab— es un N100 con 16 GB. Silencioso, x86 total y con margen para Immich más una docena de contenedores.

Nuestra elección · primer servidor

Beelink Mini S12 Pro — Intel N100, 16 GB

Tu primer servidor 24/7. Contenedores, transcodificación de vídeo por QuickSync y un puñado de servicios sin que la factura de la luz se entere. Es el que operamos nosotros.

• +iGPU con QuickSync: transcodifica por hardware
• +Consumo mínimo, silencioso de verdad
• +x86 total: cualquier contenedor corre

• -Se queda corto para virtualizar en serio (varias VM)
• -Solo una ranura NVMe

coste orientativo€€€

Ver precio en Amazon →

Para elegir con criterio según tu presupuesto y ver qué RAM admite cada equipo, tienes la comparativa de mini PC con el filtro de memoria y almacenamiento.

Una nota sobre discos: las fotos ocupan, y crecen. Immich guarda los originales tal cual, así que dimensiona el almacenamiento pensando en años, no en la biblioteca de hoy.

Cómo se organiza por dentro

Antes de instalar, ayuda entender las piezas, porque luego la copia de seguridad depende de saber qué es qué. Immich no es un programa, son cuatro contenedores Docker que trabajan juntos más una carpeta con tus archivos.

El immich-server es la web y la API: lo que ves y por donde suben las fotos. El contenedor de machine-learning hace el reconocimiento facial y la búsqueda. PostgreSQL guarda los metadatos (álbumes, caras, ajustes), Redis gestiona la cola de trabajos en segundo plano. Y aparte de todo eso, una carpeta en tu disco, UPLOAD_LOCATION, donde viven las fotos de verdad. Quédate con esto: la base de datos y las fotos son cosas separadas. Lo retomamos en la copia de seguridad.

Instalación con Docker Compose, paso a paso

Doy por hecho que ya tienes Docker y el plugin de Docker Compose instalados en el servidor. Si vienes de montar Plex o cualquier otro contenedor, ya lo tienes; si no, en la guía de servidor multimedia con Plex y Docker está el punto de partida.

La forma recomendada por el propio proyecto es descargar sus ficheros oficiales, no copiar y pegar un compose de un tutorial cualquiera (que envejece mal). Son cuatro pasos.

1. Crea la carpeta y baja los ficheros oficiales.

mkdir immich && cd immich
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

2. Edita el .env. Es un fichero de texto con las variables de configuración. Los dos valores que sí o sí quieres tocar:

• UPLOAD_LOCATION: la ruta de tu disco donde se guardarán las fotos. Ponla en un sitio con espacio de sobra (un disco de datos, no el del sistema).
• DB_PASSWORD: una contraseña para la base de datos. Cámbiala por una tuya.
• TZ: tu zona horaria, por ejemplo Europe/Madrid, para que las fechas cuadren.

3. Levanta los contenedores. Desde la misma carpeta:

docker compose up -d

Ojo: es docker compose (con espacio), la versión moderna. El viejo docker-compose con guion puede dar errores. La primera vez tarda un rato porque se descarga las imágenes.

4. Abre la web. En el navegador, http://IP-de-tu-servidor:2283. La primera cuenta que registres es la de administrador. Creas usuario, entras y ya está el servidor listo.

Para actualizar Immich cuando salga una versión nueva (repasa antes las notas de la versión por si hay cambios importantes), desde la carpeta:

docker compose pull && docker compose up -d
docker image prune   # limpia las imágenes viejas

Las apps del móvil

Aquí es donde Immich se gana el sueldo. Instala la app de Immich desde la App Store o la Play Store, mete la dirección de tu servidor (http://IP:2283) y tu usuario. Activas la copia automática, eliges qué álbumes del móvil se suben, y a partir de ahí funciona sola: cada foto nueva se sube cuando el móvil está en tu red.

Un consejo de seguridad: para subir desde fuera de casa no abras el puerto 2283 a internet a pelo. Monta una VPN (un WireGuard va perfecto) o un proxy inverso con HTTPS. Entrar en tu red de casa desde el móvil es justo para lo que sirve una VPN doméstica, y es lo que uso yo para llegar a Immich desde la calle.

La copia de seguridad (esto no te lo saltes)

Autoalojar tus fotos significa que la responsabilidad de no perderlas es tuya, no de Google. Y aquí es donde mucha gente la lía: hace copia de una pieza y se olvida de la otra.

Son dos cosas, y hacen falta las dos:

1. La base de datos. Guarda los metadatos, los álbumes, las caras reconocidas y los ajustes. Pesa poco y, sin ella, tus fotos serían un montón de ficheros sin orden ni álbumes. La buena noticia: Immich ya hace copias automáticas de la base de datos por su cuenta, dentro de UPLOAD_LOCATION/backups, con la programación y retención que quieras desde la propia web (por defecto guarda las últimas 14, una diaria). Si quieres una a mano, es un volcado del contenedor de PostgreSQL:

docker exec -t immich_postgres pg_dump --clean --if-exists \
  --dbname=immich --username=postgres | gzip > immich-db.sql.gz

2. Tus archivos. La carpeta UPLOAD_LOCATION entera, que es donde están las fotos y vídeos originales. Esto es lo insustituible y lo que más pesa. Cópiala a otro disco o a otro equipo con lo que uses para el resto de tus copias: rsync, Borg, Restic, o la función de backup de tu NAS.

El detalle que hay que entender: la copia de la base de datos por sí sola no restaura tus fotos, porque solo guarda metadatos. Necesitas las dos piezas. Y aplica la regla de siempre, la 3-2-1: tres copias, en dos medios distintos, una fuera de casa. Que un incendio o un robo no se lleve a la vez el servidor y su única copia.

Para restaurar en un equipo nuevo: instala la misma versión de Immich, devuelve la carpeta a su UPLOAD_LOCATION y restaura la base de datos. Con las dos piezas en su sitio, vuelves a tener tu galería tal cual estaba.

Tres cosas que se atascan (y cómo salir)

Ningún montaje sale perfecto a la primera. Los tropiezos más habituales con Immich, y por dónde tirar cuando pasan:

El contenedor de IA se reinicia solo o se queda sin memoria. Casi siempre es RAM. El reconocimiento facial y la búsqueda inteligente son lo más goloso de Immich. Si vas justo de memoria, la primera opción es darle más; la segunda, entrar en los ajustes y bajar la concurrencia de los trabajos de IA para que no procese tantas fotos a la vez. Y si tu equipo es muy modesto, siempre puedes desactivar la IA y quedarte con la copia de seguridad y los álbumes, que van sobrados con 4 GB.

La app del móvil no encuentra el servidor. Nueve de cada diez veces es la dirección. Comprueba que pones http:// (no https:// si no has montado certificado), la IP correcta de tu servidor en la red local y el puerto :2283. Si desde el navegador del propio móvil, en la wifi de casa, no abre esa dirección, el problema es de red, no de Immich: revisa que el servidor y el móvil están en la misma red.

Una actualización rompió algo. Pasa, porque el proyecto va rápido. La regla de oro: antes de actualizar, lee las notas de la versión, que avisan de los cambios importantes. Si ya te ha pillado, casi todo se resuelve con docker compose down && docker compose up -d para recrear los contenedores limpios. Y si la cosa es seria, para eso hiciste la copia de seguridad: es tu red de emergencia, no un trámite.

La lección general, que sirve para Immich y para todo el homelab: si algo falla, mira los registros del contenedor con docker compose logs, que casi siempre te dicen qué pasa en la última línea. Medio homelab se arregla leyendo el error en vez de reinstalar a ciegas.

Immich es, para mí, el mejor primer proyecto “que importa” de un homelab: útil desde el minuto uno, agradecido con hardware modesto y con una recompensa clara cuando cancelas la cuota de fotos en la nube. Móntalo, dale unos días para que procese tu biblioteca, y configura la copia de seguridad antes de borrar nada de la nube. En ese orden.