View source for Immich

<span id="administration"></span>
= Administration =

* Admin credentials are stored in [TODO].
* Take care not to touch the external libraries unless you know what you're doing; those are used to link users' Nextcloud data to their Immich accounts.

<span id="container-setup"></span>
= Container setup =

Immich runs in <code>docker compose</code>. All relevant files can be found in <code>/root/immich</code> on guayusa.

<span id="access"></span>
= Access =

In <code>/root/immich</code> on guayusa:
* <code>docker compose exec -it database psql -U postgres immich</code> will get you a psql shell in the Immich Postgres database.
* <code>curl https://photos.csclub.uwaterloo.ca/api/*</code> or <code>curl https://localhost:2283/api/*</code> lets you access the [https://api.immich.app/introduction Immich API]. You'll need to create an API key through the web UI -> Administration, then pass it in as the `x-api-key` header.

<span id="nginx"></span>
== Nginx ==

The Immich setup piggybacks off the nginx instance [https://wiki.csclub.uwaterloo.ca/Nextcloud#Setup_Nginx running in the Nextcloud container]. Once you've gained access to the container via <code>sudo machinectl shell nextcloud</code>, the nginx config can be found at <code>/etc/nginx/sites-available/immich</code>.

<span id="linking-nextcloud"></span>
== Linking Nextcloud ==

Every user who has logged into both Immich and Nextcloud will have an external library created in Immich, following the naming convention <code>[watiam]'s Library</code>. This allows Immich to access the user's images stored in Nextcloud, located at <code>/var/lib/machines/nextcloud/data/nextcloud-data/[watiam]/files</code>.

The libraries are created by the script <code>/root/immich/sync-libraries.sh</code>. It's in the root user's crontab, set to run every hour.

<span id="oidc-setup"></span>
== OIDC setup ==

OAuth can be configured in the web UI -> Administration from the admin account. [https://immich.app/docs/administration/oauth Documentation].