Immich - Revision history

GinnyGlider: Add note for setting Immich log level and reducing Redis log verbosity.

2026-04-24T17:01:04Z

Add note for setting Immich log level and reducing Redis log verbosity.

← Older revision		Revision as of 17:01, 24 April 2026
Line 9:		Line 9:
	{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.host = "0.0.0.0";		{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.host = "0.0.0.0";
	services.immich.openFirewall = true;}}		services.immich.openFirewall = true;}}
	More options are available: {{nixos:option\|services.immich.}}
			To change Immich’s default log verbosity, you can set the [https://docs.immich.app/install/environment-variables#general <code>IMMICH_LOG_LEVEL</code>] environment variable:
			{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.environment.IMMICH_LOG_LEVEL = "warn";}}
			More options are available: {{nixos:option\|services.immich.}}

	== Tips and Tricks ==		== Tips and Tricks ==

			=== Reducing Log Verbosity Of Redis ===

			As noted in the [https://docs.immich.app/FAQ/#how-can-i-reduce-the-log-verbosity-of-redis Immich FAQ], you can reduce Redis log verbosity by setting the log level to warning. In NixOS this is done with the [https://search.nixos.org/options?show=services.redis.servers.%3Cname%3E.logLevel log Level option] of the Redis server that Immich uses:

			{{file\|/etc/nixos/configuration.nix\|nix\|3=services.redis.servers.immich.logLevel = "warning";}}
			{{info\|Valid log levels for Redis are <code>debug</code>, <code>verbose</code>, <code>notice</code>, and <code>warning</code>.}}

	=== Custom Media Location ===		=== Custom Media Location ===
Line 71:		Line 81:
	== Troubleshooting ==		== Troubleshooting ==

	=== Fixing ~~postgresql~~ database issue after 25.05 upgrade ===		=== Fixing PostgreSQL database issue after 25.05 upgrade ===

	==== ~~Postgresql~~ collation version mismatch ====		==== PostgreSQL collation version mismatch ====
	After upgrading you might run into an issue like this, leading to immich-server continuously failing and restarting: <syntaxhighlight>Jul 01 14:23:12 server2 immich[178592]: Postgres notice: {		After upgrading you might run into an issue like this, leading to immich-server continuously failing and restarting: <syntaxhighlight>Jul 01 14:23:12 server2 immich[178592]: Postgres notice: {
	Jul 01 14:23:12 server2 immich[178592]: severity_local: 'WARNING',		Jul 01 14:23:12 server2 immich[178592]: severity_local: 'WARNING',

34j: /* Custom Media Location */

2026-02-27T07:55:52Z

Custom Media Location

← Older revision		Revision as of 07:55, 27 February 2026
Line 20:		Line 20:

	{{warning\|If you have used Immich before, changing this option will completely stop Immich service, disabling access from browser. You may need to reset / remove Postgresql database.}}		{{warning\|If you have used Immich before, changing this option will completely stop Immich service, disabling access from browser. You may need to reset / remove Postgresql database.}}

			{{info\|If you only need to change the location where raw data is stored, [https://docs.immich.app/guides/external-library/ External Libraries] may be used.}}

	=== Enabling Hardware Accelerated Video Transcoding ===		=== Enabling Hardware Accelerated Video Transcoding ===

34j at 07:51, 27 February 2026

2026-02-27T07:51:39Z

← Older revision		Revision as of 07:51, 27 February 2026
Line 13:		Line 13:
	== Tips and Tricks ==		== Tips and Tricks ==

	=== Custom Media Location ==		=== Custom Media Location ===
	While the official Immich documentation recommends modifying <code>UPLOAD_LOCATION</code> environmental variable for Docker build, NixOS does not support modifying it. Instead, {{nixos:option\|services.immich.mediaLocation}} may be used, which simply sets [https://docs.immich.app/install/environment-variables/　<code>IMMICH_MEDIA_LOCATION</code>] variable, while this is not recommended in the official documentation:		While the official Immich documentation recommends modifying <code>UPLOAD_LOCATION</code> environmental variable for Docker build, NixOS does not support modifying it. Instead, {{nixos:option\|services.immich.mediaLocation}} may be used, which simply sets [https://docs.immich.app/install/environment-variables/　<code>IMMICH_MEDIA_LOCATION</code>] variable, while this is not recommended in the official documentation:

34j: Add /* Custom Media Location */

2026-02-27T07:51:24Z

Add Custom Media Location

← Older revision		Revision as of 07:51, 27 February 2026
Line 12:		Line 12:

	== Tips and Tricks ==		== Tips and Tricks ==

			=== Custom Media Location ==
			While the official Immich documentation recommends modifying <code>UPLOAD_LOCATION</code> environmental variable for Docker build, NixOS does not support modifying it. Instead, {{nixos:option\|services.immich.mediaLocation}} may be used, which simply sets [https://docs.immich.app/install/environment-variables/　<code>IMMICH_MEDIA_LOCATION</code>] variable, while this is not recommended in the official documentation:

			{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.mediaLocation = "/var/lib/immich";
			}}

			{{warning\|If you have used Immich before, changing this option will completely stop Immich service, disabling access from browser. You may need to reset / remove Postgresql database.}}

	=== Enabling Hardware Accelerated Video Transcoding ===		=== Enabling Hardware Accelerated Video Transcoding ===

34j: Add description about host and openFirewall

2026-02-13T14:48:44Z

Add description about host and openFirewall

← Older revision		Revision as of 14:48, 13 February 2026
Line 5:		Line 5:
	{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.enable = true;		{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.enable = true;
	services.immich.port = 2283;}}		services.immich.port = 2283;}}

			To access Immich from other devices via network, add the following as well:
			{{file\|/etc/nixos/configuration.nix\|nix\|3=services.immich.host = "0.0.0.0";
			services.immich.openFirewall = true;}}
	More options are available: {{nixos:option\|services.immich.}}		More options are available: {{nixos:option\|services.immich.}}

Arcstur: /* Using borg for backups */ use "config.services.immich.mediaLocation" instead of hardcoding the path

2025-11-22T12:57:13Z

Using borg for backups: use "config.services.immich.mediaLocation" instead of hardcoding the path

← Older revision		Revision as of 12:57, 22 November 2025
Line 44:		Line 44:
	Following Immichs [https://immich.app/docs/administration/backup-and-restore/ backup docs] and [https://immich.app/docs/guides/template-backup-script backup script] an automated backup using [[Borg backup]] could look something like this:		Following Immichs [https://immich.app/docs/administration/backup-and-restore/ backup docs] and [https://immich.app/docs/guides/template-backup-script backup script] an automated backup using [[Borg backup]] could look something like this:
	{{File\|3=services.borgbackup.jobs."Immich" = {		{{File\|3=services.borgbackup.jobs."Immich" = {
	paths = ~~"/var/lib/~~immich";		paths = config.services.immich.mediaLocation;
	repo = "<path-to-borg-repo>";		repo = "<path-to-borg-repo>";
	startAt = "Sat 04:00";		startAt = "Sat 04:00";

Widlarizer: Fixed postgres username

2025-11-05T00:09:38Z

Fixed postgres username

← Older revision		Revision as of 00:09, 5 November 2025
Line 78:		Line 78:
	If you still run into issues after restarting postgresql and immich-server services, some additional postgresql database changes might be necessary to [https://web.archive.org/web/20240910231531/https://docs.pgvecto.rs/admin/upgrading.html#upgrading upgrade pgvecto.rs table]:		If you still run into issues after restarting postgresql and immich-server services, some additional postgresql database changes might be necessary to [https://web.archive.org/web/20240910231531/https://docs.pgvecto.rs/admin/upgrading.html#upgrading upgrade pgvecto.rs table]:

	Run <code>sudo -u ~~postgresql~~ psql</code> and execute consecutively:<syntaxhighlight lang="sql" line="1">		Run <code>sudo -u postgres psql</code> and execute consecutively:<syntaxhighlight lang="sql" line="1">
	CREATE EXTENSION IF NOT EXISTS unaccent;		CREATE EXTENSION IF NOT EXISTS unaccent;
	CREATE EXTENSION IF NOT EXISTS "uuid-ossp";		CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

Larsianer: Fix typo

2025-10-22T19:38:13Z

Fix typo

← Older revision		Revision as of 19:38, 22 October 2025
Line 70:		Line 70:
	Jul 01 14:23:12 server2 immich[178592]: line: '477',		Jul 01 14:23:12 server2 immich[178592]: line: '477',
	Jul 01 14:23:12 server2 immich[178592]: routine: 'CheckMyDatabase'		Jul 01 14:23:12 server2 immich[178592]: routine: 'CheckMyDatabase'
	Jul 01 14:23:12 server2 immich[178592]: }</syntaxhighlight>To fix this, run <code>sudo -u immich psql -d immich</code> and execute these to commands:<syntaxhighlight lang="sql" line="1">		Jul 01 14:23:12 server2 immich[178592]: }</syntaxhighlight>To fix this, run <code>sudo -u immich psql -d immich</code> and execute these two commands:<syntaxhighlight lang="sql" line="1">
	ALTER DATABASE immich REFRESH COLLATION VERSION;		ALTER DATABASE immich REFRESH COLLATION VERSION;
	REINDEX DATABASE immich;		REINDEX DATABASE immich;

AzomDev: Add under Troubleshooting: note that if Immich on nixos-stable is too old and causes client sync errors, set services.immich.package = pkgs.unstable.immich;.

2025-09-22T02:51:05Z

Add under Troubleshooting: note that if Immich on nixos-stable is too old and causes client sync errors, set services.immich.package = pkgs.unstable.immich;.

@@ Line 88: / Line 88: @@
 SELECT pgvectors_upgrade();
 </syntaxhighlight>Finally, restart postgresql and immich: <code>systemctl restart postgresql && systemctl restart immich-server</code>
 [[Category:Server]]
 [[Category:Web Applications]]

StrangeGirlMurph: add tip for borg backup

2025-09-14T11:05:55Z

add tip for borg backup

@@ Line 40: / Line 40: @@
 };
 }}
 == Troubleshooting ==