---
title: "Immich"
description: "Immich is a built-in integration for Home Assistant. It has 3.6k installs sharing analytics and works locally."
canonical: "https://vulpo.app/integrations/core/immich"
url: "https://vulpo.app/integrations/core/immich.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Immich

> Immich is a built-in integration for Home Assistant. It has 3.6k installs sharing analytics and works locally.

Immich is a built-in integration that connects Home Assistant to an Immich photo and video server over the local network. It adds sensors for disk size, available space, and used space, including the share taken by photos and by videos, along with photo and video totals. An update entity reports the version of the Immich server. An upload file action sends a file to the Immich instance from Home Assistant. It is set up in the UI with the server URL and an API key, and an option controls whether the SSL certificate is verified. Connection settings can be changed later without removing the integration, and a diagnostics file can be downloaded for bug reports.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=immich)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Change settings later**: Its connection settings can change without removing it.
- **Platinum quality**: Home Assistant's own rating of its code and setup experience.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### Connect

- **API key**: API key to connect to your Immich instance.
- **URL**: The full URL of your Immich instance.
- **Verify SSL certificate**: Whether to verify the SSL certificate when SSL encryption is used to connect to your Immich instance.

### Sign in again

- **API key**: API key to connect to your Immich instance.

### Change the connection

- **URL**: The full URL of your Immich instance.
- **Verify SSL certificate**: Whether to verify the SSL certificate when SSL encryption is used to connect to your Immich instance.

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Sensors**: Disk available, Disk size, Disk usage, Disk used, Photos count, Disk used by photos, Disk used by videos, Videos count
- **Updates**: Version

## Actions

- **Upload file**: Uploads a file to your Immich instance.
  Fields: Album ID, Immich instance, File

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## At a glance

- Kind: Built-in integration
- Category: [Productivity and information](https://vulpo.app/integrations/category/productivity-and-information.md), Documents and photos
- Brand: [Immich](https://vulpo.app/integrations/immich.md)
- Number: 3.6k installs sharing analytics
- Connection: Works locally
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Quality scale: Platinum quality scale
- Domain: `immich`
- Source: <https://www.home-assistant.io/integrations/immich/>

In Vulpo: Chart card, Apple Watch

## Other ways in for Immich

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [Immich Gallery](https://github.com/ofilis/ha-immich-gallery) | Marketplace integration | 43 installs sharing analytics | Works locally | Updated in the last 6 months |
| [Immich Frame](https://github.com/mpross512/ha-immich-frame) | Marketplace integration | 17 installs sharing analytics | Connection not stated | Updated in the last 6 months |
| [Immich Random Image](https://github.com/strickdd/ImmichRandomImage) | Marketplace integration | 10 installs sharing analytics | Works locally | Updated in the last 6 months |
| [Immich](https://vulpo.app/integrations/apps/immich.md) | App | 525 installs sharing analytics | Connection not stated | Updated in the last 6 months |
| [Immich Power Tools](https://github.com/alexbelgium/hassio-addons) | App | 100 installs sharing analytics | Connection not stated | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/immich

---

- HTML version of this page: https://vulpo.app/integrations/core/immich
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml