Files
immich/README.md
2026-01-11 21:41:43 +01:00

48 lines
1.5 KiB
Markdown

# immich
> One line description of the recipe
<!-- metadata -->
* **Category**: Apps
* **Status**: 1
* **Image**: [`immich`](https://hub.docker.com/r/immich), 4, upstream
* **Healthcheck**: No
* **Backups**: No
* **Email**: 1
* **Tests**: No
* **SSO**: 1 (Oauth)
<!-- endmetadata -->
## Quick start
* `abra app new immich --secrets`
* `abra app config <app-name>`
* `abra app deploy <app-name>`
For more, see [`docs.coopcloud.tech`](https://docs.coopcloud.tech).
## How do I integrate with Keycloak SSO?
See https://docs.immich.app/administration/oauth/. The `ISSUER_URL` in the Immich settings should be `https://<sso-domain>/realms/<realm_name>/.well-known/openid-configuration`.
## Volume
You can manually create a volume that has more storage for the library. For example samba: https://docs.docker.com/engine/storage/volumes/#create-cifssamba-volumes
```
docker volume create \
--driver local \
--opt type=cifs \
--opt device=//uxxxxx.your-server.de/backup \
--opt o=addr=uxxxxx.your-server.de,username=uxxxxxxx,password=*****,file_mode=0777,dir_mode=0777 \
--name immich_example_com_uploads
```
## External Library
If you want to use the [external library functionality](https://docs.immich.app/guides/external-library/) of immich via a cifs/smb-share-drive you can use the additional `compose.storage.yml` file.
Just uncomment and edit the respective .env-files.
The external storage will be mounted to `/mnt/external_storage` (this is your import path in immich).