Immich — Fotos y vídeos familiares con IA local¶

Sustituiría a Google Fotos. Todas las fotos y vídeos de la familia se almacenan en tu servidor, con reconocimiento facial, búsqueda por lugares y objetos, y copia de seguridad automática desde el móvil. Las imágenes nunca salen de casa ni entrenan sistemas de IA ajenos.

Como usuario¶

Qué podrás hacer¶

Subir fotos y vídeos automáticamente desde el móvil (solo por WiFi)
Buscar por cara: el sistema aprende las caras de la familia y las agrupa
Buscar por lugar, fecha o con lenguaje natural ("playa con los niños en verano")
Crear álbumes compartidos con otros miembros de la familia
Ver las fotos en el navegador, en la app del móvil o en la televisión
Compartir álbumes con personas externas mediante enlace temporal
Migrar desde Google Fotos: el administrador puede importar los archivos de Google Takeout conservando fechas y metadatos

Cómo se accederá¶

Plataforma	Cómo
Navegador	`https://fotos.sc`
Ubuntu	Navegador (no hay cliente de escritorio nativo)
Android	App Immich desde Google Play
FireTV	App Immich desde Amazon Store

Primeros pasos (previstos)¶

En el móvil Android: Instala la app Immich → introduce la URL del servidor: https://fotos.sc → inicia sesión con tu usuario SmallCountry. Ve a Ajustes → Copia de seguridad → actívala → elige "Solo por WiFi". Las fotos nuevas se suben automáticamente cada vez que te conectas al WiFi de casa. La primera sincronización puede tardar si tienes muchas fotos; déjala correr con el móvil enchufado.

En FireTV: Instala Immich desde la tienda de apps de Amazon → misma URL de servidor → inicia sesión. Ideal para ver los álbumes familiares en la tele.

Para buscar: Escribe en el buscador lo que quieras: "playa", "cumpleaños", "navidad", "gato". La IA local reconoce objetos, escenas y texto dentro de las imágenes.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Nextcloud	Las fotos de Immich se montan como carpeta externa de solo lectura en Nextcloud. Se pueden ver y descargar desde Archivos, pero la gestión (subir, etiquetar, borrar) se hace desde Immich
Authentik	Autenticación vía OAuth2/OIDC. Mismo login que para todo SmallCountry
Caddy	Proxy inverso. `fotos.sc` → Caddy → Immich
n8n	Automatizaciones: al subir X fotos a un álbum, n8n puede notificar a la familia o generar un resumen
Ollama + Qdrant	Si Horus (servidor secundario con GPU para IA) está encendido, el ML pesado (reconocimiento facial, búsqueda semántica avanzada) se deriva a la GPU (procesador gráfico (usado para IA))

Servicios que lo hacen posible¶

Immich — aplicación principal
PostgreSQL con pgvector — base de datos con búsqueda vectorial para similitud de imágenes
Redis — cola de jobs de machine learning
ZFS — almacenamiento de las fotos originales con integridad verificada

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	151
IP	10.10.20.151
Tier	B
Impacto	🔴 Crítico — contiene los recuerdos familiares

Almacenamiento persistente¶


ZFS (sistema de archivos con integridad de datos) dataset	`rpool/datos/immich`
Montaje en LXC	`/opt/immich/`
Subdirectorios	`library/` (fotos originales), `pgdata/` (base de datos), `redis/`
Backup	PBS (sistema de copias de seguridad de Proxmox) diario (03:00) + ZFS snapshot cada 15 min

Docker Compose¶

immich-server:
  image: ghcr.io/immich-app/immich-server:latest
immich-machine-learning:
  image: ghcr.io/immich-app/immich-machine-learning:latest
postgres:
  image: tensorchord/pgvector:pg16
redis:
  image: redis:7.2.5

Healthcheck¶

docker exec immich-server immich admin list-users
docker exec immich-server immich admin jobs
curl -s https://fotos.sc/api/server-info/version

Logs y diagnóstico¶

docker logs --tail 100 immich-server
docker logs --tail 100 immich-machine-learning

Backup manual¶

docker exec immich-postgres pg_dumpall -U postgres > /tmp/immich-db.sql
zfs snapshot rpool/datos/immich@manual-$(date +%Y%m%d)

Problemas comunes¶

ML no procesa fotos nuevas: Verificar que immich-machine-learning está corriendo. Si Horus está disponible, derivar allí
Base de datos lenta: docker exec immich-postgres psql -U postgres -c "REINDEX DATABASE immich;"
Fotos duplicadas tras restaurar backup: Ejecutar la herramienta de detección de duplicados de Immich desde la interfaz web
Disco lleno: Las fotos originales ocupan mucho. Monitorizar zfs list rpool/datos/immich

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    subgraph Red interna
        Caddy[Caddy LXC 102<br>10.10.10.102]
        Authentik[Authentik LXC 105<br>10.10.10.105]
    end
    subgraph Immich
        Server[Immich Server<br>LXC 151<br>10.10.20.151]
        ML[Immich ML<br>LXC 151 :3003]
        PSQL[(PostgreSQL<br>pgvector)]
        Redis[(Redis)]
    end
    subgraph IA
        Horus[Horus GPU<br>Ollama + Qdrant]
    end
    subgraph Nextcloud
        NC[Nextcloud LXC 150]
    end
    Caddy -->|TLS| Server
    Authentik -->|OAuth2| Server
    Server --> PSQL
    Server --> Redis
    Server -->|ML jobs| ML
    ML -.->|si Horus ON| Horus
    Server -->|External Storage| NC

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr2	2283	Caddy (LXC 102, IP 10.10.10.102)
vmbr2	3003	ML interno (solo desde Immich Server)

En Pi-hole¶

fotos.sc  →  10.10.20.151

En Caddy¶

fotos.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.151:2283
}

En Authentik¶


Provider	OAuth2/OIDC
Grupos asignados	`familia`

Orquestación¶

Componente	Path
Rol Ansible	`roles/immich/`
Playbook	`deploy-immich.yml`
Módulo OpenTofu	`modules/immich/`
Semaphore	Proyecto `immich`, Template `deploy`
Forgejo Actions	`.forgejo/workflows/immich.yml`
Repo Forgejo	`infra-core/`
Ficha versionada	`docs/fichas/immich.md`

Notas de arquitectura¶

QuickSync para ML si está disponible en CPU Intel. pgvector proporciona búsqueda vectorial de similitud entre imágenes. Si Horus está encendido (GPU RTX 2070), el ML pesado se deriva automáticamente a la GPU para mayor velocidad. En modo solo CPU (Horus apagado), el reconocimiento facial es más lento pero funcional.

Captura de pantalla¶

Immich — Álbum de fotos familiar

📸 Pendiente de captura desde la instancia en producción. Sustituye esta imagen por una captura real de https://fotos.sc.

Secciones relacionadas¶

🌐 Enlaces de interés¶

Immich · Documentación · GitHub