website/integrations: add Immich (#7829)
This commit is contained in:
parent
1e3feca4b6
commit
f9b998e814
48
website/integrations/services/immich/index.md
Normal file
48
website/integrations/services/immich/index.md
Normal file
|
@ -0,0 +1,48 @@
|
|||
---
|
||||
title: Immich
|
||||
---
|
||||
|
||||
<span class="badge badge--secondary">Support level: Community</span>
|
||||
|
||||
## What is Immich
|
||||
|
||||
> Immich is a self-hosted backup solution for photos and videos on mobile devices.
|
||||
>
|
||||
> -- https://immich.app/
|
||||
|
||||
## Preparation
|
||||
|
||||
The following placeholders will be used:
|
||||
|
||||
- `https://immich.company` is the URL used to access the Immich instance.
|
||||
- `authentik.company` is the FQDN of the authentik install.
|
||||
|
||||
## authentik configuration
|
||||
|
||||
1. Create a new OAuth2/OpenID Provider using the following settings:
|
||||
- **Name**: Immich
|
||||
- **Authentication flow**: default-authentication-flow
|
||||
- **Authorization flow**: default-provider-authorization-explicit-consent
|
||||
- **Client type**: Confidential
|
||||
- **Client ID**: Either create your own Client ID or make a note of the auto-populated one
|
||||
- **Client Secret**: Either create your own Client Secret or make a note of the auto-populated one
|
||||
- **Redirect URIs/Origins (RegEx)**:
|
||||
_Please note that the following URIs are just examples. Be sure to include all of the domains / URLs that you will use to access Immich._
|
||||
- app.immich:/
|
||||
- https://immich.company/auth/login
|
||||
- https://immich.company/user-settings
|
||||
- **Signing Key**: authentik Self-signed Certificate
|
||||
- Leave everything else as default
|
||||
2. Open the new provider you've just created.
|
||||
3. Make a note of the **OpenID Configuration Issuer**.
|
||||
|
||||
## Immich Configuration
|
||||
|
||||
Immich documentation can be found here: https://immich.app/docs/administration/oauth
|
||||
|
||||
1. In Immich, navigate to **Administration** > **Settings** > **OAuth Authentication**
|
||||
2. Configure Immich as follows:
|
||||
- **Issuer URL**: Populate this field with the `OpenID Configuration Issuer`
|
||||
- **Client ID**: Enter your Client ID from authentik
|
||||
- **Client Secret**: Enter your Client Secret from authentik
|
||||
- **Scope**: `openid email profile`
|
|
@ -100,6 +100,7 @@ module.exports = {
|
|||
"services/freshrss/index",
|
||||
"services/gravitee/index",
|
||||
"services/home-assistant/index",
|
||||
"services/immich/index",
|
||||
"services/jellyfin/index",
|
||||
"services/node-red/index",
|
||||
"services/sonar-qube/index",
|
||||
|
|
Reference in a new issue