---
title: "Immich Gallery"
description: "Immich Gallery is a Marketplace integration for Home Assistant. It has 50 installs sharing analytics, works locally and was last updated November 2, 2026."
canonical: "https://vulpo.app/integrations/marketplace/ofilis-ha-immich-gallery"
url: "https://vulpo.app/integrations/marketplace/ofilis-ha-immich-gallery.md"
last-updated: "2026-11-22"
version: "1.4"
---

# Immich Gallery

> Immich Gallery is a Marketplace integration for Home Assistant. It has 50 installs sharing analytics, works locally and was last updated November 2, 2026.

From the [repository description](https://github.com/ofilis/ha-immich-gallery):

> Rotating Immich album, favorite, and library images for Home Assistant

[Open in My Home Assistant](https://my.home-assistant.io/redirect/marketplace_repository/?owner=ofilis&repository=ha-immich-gallery&category=integration)

On Home Assistant 2026.10 or older? [Open it in HACS](https://my.home-assistant.io/redirect/hacs_repository/?owner=ofilis&repository=ha-immich-gallery&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Connect to Immich

- **Immich URL**: HTTPS, local HTTP, Tailscale IP, and MagicDNS hostnames are supported. A trailing /api is accepted.
- **API key**: The key is sent only in the x-api-key header.
- **Verify TLS certificate**: Keep enabled unless the server deliberately uses a trusted private certificate.

### Choose image sources

- **Random image from the whole library**
- **Random image from favorites**
- **Albums**
- **Recent images remembered per source**: Prevents this many recently shown images for each source from being selected again when alternatives are available. Use 0 to disable.
- **Refresh interval**: Minutes between image changes. Enter a value from 1 to 60.
- **Automatic slideshow**: Change images automatically. Turn off to advance only with buttons or automations.

### Update the Immich API key

- **New API key**

### Reconfigure the Immich server

- **Immich URL**
- **Verify TLS certificate**

### After setup

- **Immich host**: HTTPS, local HTTP, Tailscale IP, and MagicDNS hostnames are supported. A trailing /api is accepted.
- **New API key (optional)**: Leave blank to keep the current key.
- **Verify TLS certificate**: Keep enabled for HTTPS unless the server deliberately uses a trusted private or self-signed certificate.
- **Random image from the whole library**
- **Random image from favorites**
- **Albums**
- **Recent images remembered per source**: Prevents this many recently shown images for each source from being selected again when alternatives are available. Use 0 to disable.
- **Refresh interval**: Minutes between image changes. Enter a value from 1 to 60.
- **Automatic slideshow**: Change images automatically. Turn off to advance only with buttons or automations.

Texts from the code of [ofilis/ha-immich-gallery](https://github.com/ofilis/ha-immich-gallery).

## Entities

- **Buttons**: Next image
- **Images**: Random library, Random favorites
- **Numbers**: Refresh interval
- **Switches**: Automatic slideshow

## Troubleshooting

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

## From the README

> Bring your self-hosted Immich photos into Home Assistant.
>
> Display a rotating photo from your entire library, favorites, or selected albums — with no cloud relay or third-party service.
>
> - Server-side random selection that remains efficient with large libraries
> - Repeat avoidance for recently displayed images
> - Rotation interval from 1 to 60 minutes
> - A Next image button for every source, usable from dashboards and automations
> - Live interval slider and Automatic slideshow switch
> - Album, favorites, and whole-library sources
> - Settings that can be changed later without reinstalling
> - HTTPS, local HTTP, reverse proxies, and Tailscale addresses
> - Immich-generated previews for HEIC, HEIF, RAW, TIFF, and other supported formats
> - No telemetry, analytics, cloud relay, or external runtime service

From the README of [ofilis/ha-immich-gallery](https://github.com/ofilis/ha-immich-gallery#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace 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: 50 installs sharing analytics; 3 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v0.2.1, last updated November 2, 2026
- Domain: `immich_gallery`
- Source: <https://github.com/ofilis/ha-immich-gallery>
- Issues: <https://github.com/ofilis/ha-immich-gallery/issues>

In Vulpo: Quick Toggle card, Button card, Apple Watch, Control Center

## Other ways in for Immich

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [Immich](https://vulpo.app/integrations/core/immich.md) | Built-in integration | 3.8k installs sharing analytics | Works locally | Part of Home Assistant |
| [Immich Random Image](https://github.com/strickdd/ImmichRandomImage) | Marketplace integration | 19 installs sharing analytics | Works locally | Updated in the last 6 months |
| [Immich Frame](https://github.com/mpross512/ha-immich-frame) | Marketplace integration | 16 installs sharing analytics | Connection not stated | No update in 6 to 18 months |
| [Immich](https://vulpo.app/integrations/apps/immich.md) | App | 539 installs sharing analytics | Connection not stated | Updated in the last 6 months |
| [Immich Frame](https://github.com/alexbelgium/hassio-addons) | App | 105 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-11-22. Source: https://vulpo.app/integrations/marketplace/ofilis-ha-immich-gallery

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/ofilis-ha-immich-gallery
- 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
