2.8 KiB
title, description, ha_category, ha_release, ha_config_flow, ha_iot_class, ha_domain, ha_platforms, ha_codeowners, ha_integration_type, ha_quality_scale
| title | description | ha_category | ha_release | ha_config_flow | ha_iot_class | ha_domain | ha_platforms | ha_codeowners | ha_integration_type | ha_quality_scale | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Immich | Instructions on how to integrate an Immich user account into Home Assistant. |
|
2025.6 | true | Local Polling | immich |
|
|
integration | silver |
This integration allows adding an Immich user account to Home Assistant.
Prerequisites
You need to obtain the API key for your user account in your Immich instance.
{% include integrations/config_flow.md %}
{% configuration_basic %}
URL:
description: "The URL of your Immich instance. (e.g. https://immich.example.com)."
API key:
description: "API key of your user account to connect to your Immich instance."
Verify SSL certificate:
description: "Whether to verify the SSL certificate when SSL encryption is used to connect to your Immich instance."
{% endconfiguration_basic %}
Data fetching
The integration polls data every 60 seconds.
Media source
A media source is provided for your Immich albums. It shows only the albums you own or that are shared with you. If you have multiple Immich integrations in Home Assistant (one integration for each Immich user), only the albums for that specific user are shown.
Sensors
The following {% term sensors %} are created. For some of those the API key needs to have admin rights.
| Entity | Description | Default enabled |
|---|---|---|
| Disk size | Overall size of the disk | ✅ |
| Disk available | Free space on the disk | ✅ |
| Disk used | Used space on the disk | ❌ |
| Disk usage | Usage of the disk in percentage | ❌ |
| Photos count | Count of stored photos (admin only) | ✅ |
| Videos count | Count of stored videos (admin only) | ✅ |
| Disk used by photos | Used disk space by photos (admin only) | ❌ |
| Disk used by videos | Used disk space by videos (admin only) | ❌ |
Troubleshooting
In any case, when reporting an issue, please enable debug logging, restart the integration, and as soon as the issue re-occurs, stop the debug logging again (download of debug log file will start automatically). Further, if still possible, please also download the diagnostics data. If you have collected the debug log and the diagnostics data, provide them with the issue report.
Remove the integration
{% include integrations/remove_device_service.md %}
If the API key is not used anymore, you can remove it from your Immich instance.