Immich: Difference between revisions

Latest revision as of 07:33, 5 February 2025

Immich is a self-hosted photo and video management solution.

Installation

To install Immich, add the following to your NixOS configuration:

/etc/nixos/configuration.nix

services.immich.enable = true;
services.immich.port = 2283;

More options are available: services.immich.

Tips and Tricks

Enabling Hardware Accelerated Video Transcoding

Add the Immich user to the render and video groups, override the PrivateDevices service config setting to allow the service to access /dev/dri/ and enable Accelerated Video Playback on your system:

/etc/nixos/configuration.nix

# `null` will give access to all devices.
# You may want to restrict this by using something like `[ "/dev/dri/renderD128" ]`
services.immich.accelerationDevices = null;

hardware.graphics = { 
 # ...
 # See: https://wiki.nixos.org/wiki/Accelerated_Video_Playback
};

users.users.immich.extraGroups = [ "video" "render" ];

Using Immich behind Nginx

This is a typical Nginx configuration for Immich:

/etc/nixos/configuration.nix

services.nginx.virtualHosts."immich.example.com" = {
  enableACME = true;
  forceSSL = true;
  locations."/" = {
    proxyPass = "http://[::1]:${toString config.services.immich.port}";
    proxyWebsockets = true;
    recommendedProxySettings = true;
    extraConfig = ''
      client_max_body_size 50000M;
      proxy_read_timeout   600s;
      proxy_send_timeout   600s;
      send_timeout         600s;
    '';
  };
};

@@ Line 1: / Line 1: @@
-[https://immich.app Immich] is an open source photo and video management solution, designed to provide a self-hosted alternative for managing and backing up photos and videos, with a focus on privacy and ease of use.
+[https://immich.app Immich] is a self-hosted photo and video management solution.
-== Setup ==
-The following example configuration will enable Immich locally.
+== Installation ==
+To install Immich, add the following to your NixOS configuration:
 {{file|/etc/nixos/configuration.nix|nix|3=services.immich.enable = true;
-}}To see more options, visit the [https://search.nixos.org/options?channel=unstable&query=services.immich Immich module's options page].
+services.immich.port = 2283;}}
+More options are available: {{nixos:option|services.immich.}}
-After applying the above configuration you will be able to access Immich at http://localhost:2283.
+== Tips and Tricks ==
-=== Hardware Accelerated Transcoding using VA-API ===
+=== Enabling Hardware Accelerated Video Transcoding ===
-Before anything else, make sure you have configured hardware acceleration on your system as described in [[Accelerated Video Playback]].
+Add the Immich user to the <code>render</code> and <code>video</code> groups, override the <code>PrivateDevices</code> service config setting to allow the service to access <code>/dev/dri/</code> and enable [[Accelerated Video Playback]] on your system:{{file|/etc/nixos/configuration.nix|nix|3=# `null` will give access to all devices.
+# You may want to restrict this by using something like `[ "/dev/dri/renderD128" ]`
+services.immich.accelerationDevices = null;
-To make use of hardware accelerated video transcoding using VA-API,  add your Immich user to the <code>render</code> and <code>video</code> groups.
+hardware.graphics = {
+  # ...
-If you are using the default <code>immich</code> user, you can use the following snippet to enable VA-API support.{{file|/etc/nixos/configuration.nix|nix|3=users.users.immich.extraGroups = [ "video" "render" ];
+ # See: https://wiki.nixos.org/wiki/Accelerated_Video_Playback
-}}
+};
-=== Reverse Proxy ===
+users.users.immich.extraGroups = [ "video" "render" ]; }}
-A typical [[nginx]] configuration to multiplex Immich with other web services might look like:
+=== Using Immich behind Nginx ===
+This is a typical [[Nginx]] configuration for Immich:
 {{file|/etc/nixos/configuration.nix|nix|3=services.nginx.virtualHosts."immich.example.com" = {
    enableACME = true;
@@ Line 28: / Line 30: @@
      proxyPass = "http://[::1]:${toString config.services.immich.port}";
      proxyWebsockets = true;
+    recommendedProxySettings = true;
+    extraConfig = ''
+      client_max_body_size 50000M;
+      proxy_read_timeout   600s;
+      proxy_send_timeout   600s;
+      send_timeout         600s;
+    '';
    };
 };
 }}
 [[Category:Server]]
 [[Category:Web Applications]]