Immich es una alternativa self-hosted a Google Fotos o iCloud: sube y organiza tus fotos y vídeos, con reconocimiento facial, búsqueda y copia automática desde el móvil, pero los datos se quedan en tu propio servidor. La instalación oficial recomendada es Docker Compose, con un stack que incluye el servidor, el motor de machine learning (para caras y búsqueda), PostgreSQL y Redis.
Cómo instalar Immich, tu nube de fotos privada, con Docker Compose
- 1
Paso 1: Descarga los ficheros oficiales de Compose
El proyecto publica un
docker-compose.ymly un.envde ejemplo listos para usar en cada release, así que no hace falta escribirlos a mano.mkdir immich-app && cd immich-app 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
Paso 2: Configura el .env
Como mínimo, cambia
UPLOAD_LOCATIONa una ruta con bastante espacio libre (ahí se guardan tus fotos originales) yDB_PASSWORDa un valor propio — nunca dejes el valor de ejemplo. Descomenta y ajustaTZa tu zona horaria.# en .env UPLOAD_LOCATION=/datos/immich/library DB_PASSWORD=<contraseña-propia-solo-az09> TZ=Europe/Madrid - 3
Paso 3: Levanta el stack
Immich necesita el plugin
docker compose(con espacio), no el binario antiguodocker-compose.docker compose up -d - 4
Paso 4: Entra y crea la cuenta de administrador
La interfaz web queda disponible en el puerto 2283 del host. La primera vez que abres esa dirección, Immich te pide crear la cuenta de administrador — hazlo cuanto antes, antes de dejar el puerto accesible desde fuera de tu red.
# en el navegador http://<ip-de-tu-servidor>:2283 - 5
Paso 5: Instala la app móvil y activa la copia automática
La app de Immich para Android e iOS se conecta a la URL de tu servidor y puede subir en segundo plano todo lo que haga la cámara del móvil, igual que haría Google Fotos.
Conclusión
A partir de aquí, lo habitual es poner Immich detrás de un reverse proxy con HTTPS (Caddy o Traefik) en vez de exponer el puerto 2283 directamente, y añadir una copia de las fotos originales fuera del servidor — Immich organiza y sirve tus fotos, pero no sustituye a un backup real de UPLOAD_LOCATION.



