Immich

Photo server

Self-hosted photo and video management solution

Widgets & Capabilities

Immich AlbumShows a slideshow of your album pictures from Immich

Details

Immich Server StatsInformation about your Immich instance

Details

Adding the integration

You can find how to add the integration on the Integrations Management documentation page.

Secrets

API Key

Name	Description
API Key	API Key from the service for authentication.

Steps to retrieve the credentials:

1. Navigate to your Immich instance
2. Open your account settings or navigate to https://YOUR_IMMICH/user-settings
3. Scroll down to "API Keys"
4. Click "New API Key"
5. Enter a name, e.g. "Homarr"
6. Select the following permissions: album.statistics, album.read, album.create, user.read, user.update, asset.read, asset.download, asset.statistics, server.statistics, server.about.
   Additional permissions may be required depending on your Immich version. If you encounter authorization errors, grant any missing permissions requested by the server.
7. Create the integration in Homarr and copy the API key to there