Immich: tus fotos en casa, conectadas a Home Assistant

Descripción general

Immich es tu propio Google Fotos en casa: guarda las fotos y vídeos del móvil en tu servidor, con caras, búsqueda inteligente y álbumes. La integración oficial conecta un usuario de Immich con Home Assistant y trae:

Sensores de espacio en disco y, con una clave de administrador, número de fotos y vídeos. Cada 60 segundos, en local.
Una entidad de actualización para nuevas versiones del servidor.
Tus álbumes, personas y etiquetas en Medios → Immich.
La acción immich.upload_file para subir fotos desde Home Assistant.

Esquema: la app del móvil copia las fotos al servidor Immich en el puerto 2283, y Home Assistant se conecta a él con una clave de API para leer sensores, ver medios y subir fotos — Las fotos se quedan en tu red.

Esquema: NODARA.

Para instalarlo en Proxmox y ver más ejemplos: Tus fotos con Immich.

Requisitos

Un servidor Immich funcionando (Docker Compose en una VM; 4 núcleos y 8 GB recomendados).
Una clave de API de tu usuario: avatar → Configuración de la cuenta → Claves de API. Desde Immich 1.138 basta con los permisos de lectura, asset.upload, albumAsset.create y los de server.* que indica la documentación; antes hacía falta all.
Ajustes → Dispositivos y servicios → Añadir integración → Immich, con la URL (http://IP:2283) y la clave.
Fuente: documentación oficial de Immich en Home Assistant.

Ideas de uso

Foto del timbre a un álbum de Immich. Es el ejemplo de abajo.
Aviso cuando el disco de las fotos pasa del 85 %.
Aviso de nueva versión del servidor, para leer las notas antes de actualizar.
Contador de fotos y vídeos en el panel.
Ver tus álbumes en una tablet del salón desde Medios.
Guardar una captura de la cámara del jardín cuando detecta a alguien.

Ejemplo de uso

alias: "Foto del timbre a Immich"
triggers:
  - trigger: state
    entity_id: binary_sensor.timbre
    to: "on"
actions:
  - variables:
      fichero: "timbre_{{ now().strftime('%Y%m%d-%H%M%S') }}.jpg"
  - action: camera.snapshot
    target:
      entity_id: camera.entrada
    data:
      filename: "/media/{{ fichero }}"
  - action: immich.upload_file
    data:
      config_entry_id: TU_CONFIG_ENTRY_ID
      file:
        media_content_id: "media-source://media_source/local/{{ fichero }}"
        media_content_type: "image/jpeg"
      album_id: ID_DEL_ALBUM_TIMBRE

Cómo funciona:

camera.snapshot guarda la imagen de la cámara en la carpeta /media de Home Assistant, con la fecha y la hora en el nombre.
immich.upload_file la sube a Immich desde esa carpeta (media-source://media_source/local/…).
album_id es la última parte de la dirección del álbum en Immich; si lo quitas, la foto se sube sin álbum.
En el editor visual eliges la instancia de Immich en una lista, sin escribir el config_entry_id.

Acción

binary_sensor.timbre = on

Resultado

/media/timbre_20261102-183012.jpg
subida a Immich, álbum «Timbre»