Files
homarr/apps/docs/docs/integrations/immich/index.mdx
T

40 lines
1.3 KiB
Plaintext

---
title: "Immich"
description: "Self-hosted photo and video management."
hide_title: true
---
import { immichAlbumCarouselWidget } from "../../widgets/immich-album-carousel";
import { IntegrationHeader } from "@site/src/components/integrations/header";
import { IntegrationCapabilites } from "@site/src/components/integrations/widgets";
import { AddingIntegration } from "@site/src/components/integrations/adding";
import { IntegrationSecrets } from "@site/src/components/integrations/secrets";
import { immichIntegration } from ".";
import { immichServerStatsWidget } from "../../widgets/immich-server-stats";
<IntegrationHeader integration={immichIntegration} categories={["Photo server"]} />
### Widgets and capabilities
<IntegrationCapabilites items={[{ widget: immichAlbumCarouselWidget }, { widget: immichServerStatsWidget }]} />
### Adding the integration
<AddingIntegration />
### Secrets
Create an API key under **Immich user settings → API Keys** with these permissions:
`album.statistics`, `album.read`, `album.create`, `user.read`, `user.update`, `asset.read`, `asset.view`,
`asset.download`, `asset.statistics`, `server.statistics`, and `server.about`.
<IntegrationSecrets
secrets={[
{
credentials: ["apiKey"],
steps: ["Create the API key in Immich and copy its value into the Homarr integration."],
},
]}
/>