# 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).