Immich¶

Galería de fotos propia con reconocimiento facial e IA. URL: https://immich.matias7235.com.ar

📁 Rutas y configs¶

Qué	Dónde
Compose	`/opt/docker/immich/docker-compose.yml`
Variables de entorno	`/opt/docker/immich/.env`
Fotos	Definido en `.env` como `UPLOAD_LOCATION=/mnt/hdd_2tb/immich_data`
Base de datos	Definido en `.env` como `DB_DATA_LOCATION` (SSD)
Cache ML	Volumen Docker `model-cache` (SSD para mayor velocidad)

Contenedores: immich_server, immich_machine_learning, immich_postgres, immich_redis Puerto: 8503

💾 Backups y Restauración¶

Extracción de Base de Datos (Volcado en caliente): Immich actualiza su estructura de base de datos seguido. NUNCA copiar los datos sin hacer un dump primero:

docker exec -t immich_postgres pg_dumpall -c -U postgres > /opt/docker/immich/immich_dump.sql

⚠️ Las fotos (/mnt/hdd_2tb/immich_data) no están incluidas en el backup automático. Respaldarlas por separado a un disco externo si es necesario.

🔥 Problemas comunes| Problema | Solución |¶

| --- | --- | | Fotos no aparecen tras subir | Administration → Jobs → Run all | | Machine learning muy lento | Normal en el primer análisis o si el volumen sale del SSD | | Error EIO en encoded-video | El disco puede tener problemas — revisar `sudo dmesg | | ENOENT en cualquier subcarpeta al arrancar | Crear carpetas y archivos .immich faltantes: for dir in upload library thumbs profile backups encoded-video; do sudo mkdir -p /mnt/hdd_2tb/immich_data/$dir && sudo touch /mnt/hdd_2tb/immich_data/$dir/.immich; done && sudo chown -R 1000:1000 /mnt/hdd_2tb/immich_data/ |

🔐 Seguridad¶

Expuesto públicamente vía Caddy (HTTPS). ⚠️ Sin backend vivo (jul 2026): el HDD donde están las fotos está roto.
Las credenciales de la base de datos están en .env.
Limitar los recursos de CPU/RAM en el compose para evitar que el ML cuelgue el servidor.