Immich - Revision history

S23adhik at 07:29, 16 November 2025

2025-11-16T07:29:46Z

← Older revision		Revision as of 02:29, 16 November 2025
Line 1:		Line 1:

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

			Note: Immich has been turned off due to low usage.

	== Administration ==		== Administration ==
	* Admin credentials are stored in [TODO].		* Admin credentials are stored in [TODO].

A89shaik: Add updating instructions

2025-10-01T22:50:24Z

Add updating instructions

← Older revision		Revision as of 17:50, 1 October 2025
Line 1:		Line 1:
			<span id="administration"></span>

	== Administration ==		== Administration ==
	* Admin credentials are stored in [TODO].		* 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.		* 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 ==		== Container setup ==
	Immich runs in <code>docker compose</code>. All relevant files can be found in <code>/root/immich</code> on guayusa.		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 ==		== Access ==
	In <code>/root/immich</code> on guayusa:		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>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.		* <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="updating-immich"></span>
			== Updating Immich ==

			As root:
			* <code>cd /root/immich</code>
			* <code>docker compose pull</code>
			* <code>docker compose up -d</code>

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

A89shaik: Make headers consistent

2025-09-30T14:25:57Z

Make headers consistent

← Older revision		Revision as of 09:25, 30 September 2025
Line 1:		Line 1:
	<span id="administration"></span>
⚫	= Administration =

		⚫	== Administration ==
	* Admin credentials are stored in [TODO].		* 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.		* 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.

		⚫	== Container setup ==
	<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.		Immich runs in <code>docker compose</code>. All relevant files can be found in <code>/root/immich</code> on guayusa.

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

	In <code>/root/immich</code> on guayusa:		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>docker compose exec -it database psql -U postgres immich</code> will get you a psql shell in the Immich Postgres database.

A89shaik: Create Immich page

2025-09-30T14:25:25Z

Create Immich page

New page

= 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.


= Container setup =

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


= 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.


== 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>.


== 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.


== OIDC setup ==

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