Arch Linux User Repository

Upgrading to postgresql-17 is awkward because of pgvecto.rs if you have been using 0.2.0 as provided by AUR package pgvecto.rs-immich. If you have been using 0.3.0 as provided by AUR package pgvecto.rs-immich-bin then these extra steps are likely not required and I suggest the wiki instructions for upgrades for major version increments of postgresql are followed.

If you would like to stick at postgresql-16 please add the following to pacman.conf:

IgnorePkgs = postgresql postgresql-libs

Following the manual dump and reload in the wiki does appear to work, with a few extra steps to consider the pgvecto.rs upgrade.

Starting point is postgresql-old-upgrade installed with pgvector.rs-0.2.0. Symlink the installation outputs of pgvecto.rs into the directories used by the parallel installation of postgresql-old-upgrade.

ln -s /usr/share/postgresql/extension/vectors.control /opt/pgsql-16/share/extension/vectors.control
ln -s /usr/share/postgresql/extension/vectors--0.2.0.sql /opt/pgsql-16/share/extension/vectors--0.2.0.sql
ln -s /usr/lib/postgresql/vectors.so /opt/pgsql-16/lib/vectors.so

Then perform the database start (/opt/psql-16/bin/pg_ctl .. start), "dump" (pg_dumpall...) and database stop (/opt/psql-16/bin/pg_ctl .. start) steps in the wiki.

Upgrade to postgresql-17 and pgvecto.rs-0.3.0 (provided by pgvector.rs-immich-bin). Clear out /var/lib/postgresql/data then initialise the database (initdb...) as per the wiki.

Start the service using systemctl start postgresql and install the pgvecto.rs using the following command:

psql -c 'ALTER SYSTEM SET shared_preload_libraries = "vectors.so"'

Finally restart the postgresql service and perform the reload (psql...) steps in the wiki.

EDITED: Various clarifications

From v1.111.0, this package does not build with nodejs < v20.

@hrdl: is there documentation or a guide for either of those that I could reference? I've set up a reverse proxy before, but I'm not familiar with configuring it to strip a portion of the URL, and I've never explicitly configured tmpfiles.d.

I'm utilizing lighttpd as my web server if it helps!

I'm assuming tmpfiles.d allows a copy of a directory to be stored and accessed in /tmp/* with different permissions than the original.

@trainzkid: immich is intended to be run behind a reverse proxy that strips the api/ component from the URL. The ownership for /var/lib/immich and its subdirectories can be fixed via tmpfiles.d.

Here's a collection of errors I came across while trying to set immich up, as well as the ways I resolved them. Some of these should probably be added/updated in this aur PKGBUILD. Some of these are just dumb mistakes on my part, but may help others running into them.

 node:fs:1396
   handleErrorFromBinding(ctx);
   ^
 Error: EACCES: permission denied, mkdir 'upload/library'
     at mkdirSync (node:fs:1396:3)
     at FilesystemProvider.mkdirSync (/var/lib/immich/app/server/dist/infra/repositories/filesystem.provider.js:72:32)
     at StorageService.init (/var/lib/immich/app/server/dist/domain/storage/storage.service.js:28:32)
     at AppService.init (/var/lib/immich/app/server/dist/immich/app.service.js:28:29)
     at bootstrap (/var/lib/immich/app/server/dist/immich/main.js:31:45)
     at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {
   errno: -13,
   syscall: 'mkdir',
   code: 'EACCES',
   path: 'upload/library'
 }

/var/lib/immich/* needs proper permissions if services are ran as user immich; chmod --recursive immich:immich /var/lib/immich/ to fix.

/var/lib/immich/app/server/node_modules/@nestjs/config/dist/config.module.js:75
                 throw new Error(`Config validation error: ${error.message}`);
                 ^
 Error: Config validation error: "TYPESENSE_API_KEY" is not allowed to be empty
     at ConfigModule.forRoot (/var/lib/immich/app/server/node_modules/@nestjs/config/dist/config.module.js:75:23)
     at Object.<anonymous> (/var/lib/immich/app/server/dist/infra/infra.module.js:49:35)
     at Module._compile (node:internal/modules/cjs/loader:1254:14)
     at Module._extensions..js (node:internal/modules/cjs/loader:1308:10)
     at Module.load (node:internal/modules/cjs/loader:1117:32)
     at Module._load (node:internal/modules/cjs/loader:958:12)
     at Module.require (node:internal/modules/cjs/loader:1141:19)
     at require (node:internal/modules/cjs/helpers:110:18)
     at Object.<anonymous> (/var/lib/immich/app/server/dist/infra/index.js:19:14)
     at Module._compile (node:internal/modules/cjs/loader:1254:14)

Fix by commenting out TYPESENSE_API_KEY= in /etc/immich.conf.

unable to load "/usr/lib/vips-modules-8.14/vips-openslide.so" -- libopenslide.so.0: cannot open shared object file: No such file or directory
unable to load "/usr/lib/vips-modules-8.14/vips-poppler.so" -- libpoppler-glib.so.8: cannot open shared object file: No such file or directory

Fix by installing extra/poppler-glib.

 Error: connect ENOENT /run/redis/redis.sock
     at PipeConnectWrap.afterConnect [as oncomplete] (node:net:1494:16) {
   errno: -2,
   code: 'ENOENT',
   syscall: 'connect',
   address: '/run/redis/redis.sock'
 }

Make sure to configure redis to provide a unix socket

Error: connect EACCES /run/redis/redis.sock
    at PipeConnectWrap.afterConnect [as oncomplete] (node:net:1494:16) {
  errno: -13,
  code: 'EACCES',
  syscall: 'connect',
  address: '/run/redis/redis.sock'
}

Again, make sure to follow the redis guide on the arch wiki about providing a unix socket, specifically the socket's permissions; the immich user also needs to be added to the redis group

immich-microservices.service: Failed to set up mount namespacing: /run/systemd/unit-root/var/lib/immich/app/server/.reverse-geocoding-dump: No such file or directory
immich-microservices.service: Failed at step NAMESPACE spawning node: No such file or directory
immich-microservices.service: Main process exited, code=exited, status=226/NAMESPACE

mkdir /var/lib/immich/app/server/.reverse-geocoding-dump to fix.

I also noticed /var/lib/immich/app/server/upload/ is a symbolic link to /var/lib/immich/upload, which doesn't exist after install, so I mkdir'd it and chown'd it to immich:immich.

After fixing all these and starting all 3 services (immich-{server,web,microservices}), they run without errors and I get a first time login page at port 3000, but filling out all the fields and pressing 'sign up' does nothing. By using the browser's debugging, it looks like pressing 'sign up' sends a post req to port 3001, which is returning a 404 not found. Accessing immich-server and immich-microservices located on ports 3001 and 3002 respectively show json returning a 404 for 'Cannot GET /'. As of right now, this is as far as I've gotten. Any advice or feedback is welcomed! Let me know if these were obvious, or if there's some documentation I might have missed.

@wabi: thanks for the hint, I read it, but as I see it right now, I over read it :( I will do the next try, after it is not too hot, I also wait for my new hardware :(

Thanks Bernd

@dp20eic: did you add the immich domain names to the /etc/hosts file as localhosts? They are hard coded in immich thus they are required. See https://github.com/immich-app/immich/discussions/1657

this package no longer contains the service immich-machine-learning, due to growing difficulties with the arch python packages. Luckily immich-machine-learning can be now (as of immich 1.62) accessed via network, allowing it (and typesense) to be installed via docker and utilized via network.

Hi, I tried to get immich running in an LXC container under Proxmox, the installation with all dependencies was no problem so far, on the one hand two directories were missing, which I created later, but the services still don't start.

This is what I see at journal

Jun 07 18:32:45 arch-immich systemd[1]: Started immich server.
Jun 07 18:32:45 arch-immich (node)[115275]: immich-server.service: Failed to set up mount namespacing: /run/systemd/unit-root/var/lib/immich/upload: No such file or directory
Jun 07 18:32:45 arch-immich (node)[115275]: immich-server.service: Failed at step NAMESPACE spawning node: No such file or directory
Jun 07 18:32:45 arch-immich systemd[1]: immich-server.service: Main process exited, code=exited, status=226/NAMESPACE
Jun 07 18:32:45 arch-immich systemd[1]: immich-server.service: Failed with result 'exit-code'.
Jun 07 18:32:45 arch-immich systemd[1]: immich-server.service: Scheduled restart job, restart counter is at 1.
Jun 07 18:32:45 arch-immich systemd[1]: Stopped immich server.

After create missing Directory

Jun 07 18:33:43 arch-immich systemd[1]: immich-server.service: Main process exited, code=killed, status=4/ILL
Jun 07 18:33:43 arch-immich systemd[1]: immich-server.service: Failed with result 'signal'.
Jun 07 18:33:43 arch-immich systemd[1]: immich-server.service: Scheduled restart job, restart counter is at 1.
Jun 07 18:33:43 arch-immich systemd[1]: Stopped immich server.
Jun 07 18:33:43 arch-immich systemd[1]: Started immich server.
Jun 07 18:33:45 arch-immich sudo[115407]:  dp20eic : TTY=pts/1 ; PWD=/home/dp20eic ; USER=root ; COMMAND=/usr/bin/systemctl status immich-server.service
Jun 07 18:33:45 arch-immich systemd[1]: immich-server.service: Main process exited, code=killed, status=4/ILL
Jun 07 18:33:45 arch-immich systemd[1]: immich-server.service: Failed with result 'signal'.
Jun 07 18:33:46 arch-immich systemd[1]: immich-server.service: Scheduled restart job, restart counter is at 2.
Jun 07 18:33:46 arch-immich systemd[1]: Stopped immich server.
Jun 07 18:33:46 arch-immich systemd[1]: Started immich server.
Jun 07 18:33:47 arch-immich sudo[115433]:  dp20eic : TTY=pts/1 ; PWD=/home/dp20eic ; USER=root ; COMMAND=/usr/bin/systemctl status immich-server.service
Jun 07 18:33:48 arch-immich systemd[1]: immich-server.service: Main process exited, code=killed, status=4/ILL
Jun 07 18:33:48 arch-immich systemd[1]: immich-server.service: Failed with result 'signal'

Same with immich-microservice.service

Jun 07 18:37:07 arch-immich (node)[116212]: immich-microservices.service: Failed to set up mount namespacing: /run/systemd/unit-root/var/lib/immich/app/server/.reverse-geocoding-dump: No such file or directory
Jun 07 18:37:07 arch-immich (node)[116212]: immich-microservices.service: Failed at step NAMESPACE spawning node: No such file or directory
Jun 07 18:37:07 arch-immich systemd[1]: immich-microservices.service: Main process exited, code=exited, status=226/NAMESPACE
Jun 07 18:37:07 arch-immich systemd[1]: immich-microservices.service: Failed with result 'exit-code'.
Jun 07 18:37:07 arch-immich systemd[1]: immich-microservices.service: Scheduled restart job, restart counter is at 5.

After create directory

Jun 07 18:38:18 arch-immich systemd[1]: Started immich microservices.
Jun 07 18:38:20 arch-immich systemd[1]: immich-microservices.service: Main process exited, code=killed, status=4/ILL
Jun 07 18:38:20 arch-immich systemd[1]: immich-microservices.service: Failed with result 'signal'.
Jun 07 18:38:21 arch-immich systemd[1]: immich-microservices.service: Scheduled restart job, restart counter is at 1.
Jun 07 18:38:21 arch-immich systemd[1]: Stopped immich microservices.
Jun 07 18:38:21 arch-immich systemd[1]: Started immich microservices.
Jun 07 18:38:23 arch-immich systemd[1]: immich-microservices.service: Main process exited, code=killed, status=4/ILL
Jun 07 18:38:23 arch-immich systemd[1]: immich-microservices.service: Failed with result 'signal'.
Jun 07 18:38:23 arch-immich systemd[1]: immich-microservices.service: Scheduled restart job, restart counter is at 2.
Jun 07 18:38:23 arch-immich systemd[1]: Stopped immich microservices.
Jun 07 18:38:23 arch-immich systemd[1]: Started immich microservices.
Jun 07 18:38:26 arch-immich systemd[1]: immich-microservices.service: Main process exited, code=killed, status=4/ILL
Jun 07 18:38:26 arch-immich systemd[1]: immich-microservices.service: Failed with result 'signal'.
Jun 07 18:38:26 arch-immich systemd[1]: immich-microservices.service: Scheduled restart job, restart counter is at 3.
Jun 07 18:38:26 arch-immich systemd[1]: Stopped immich microservices.

Redis and postgresql are up and running, immich-web.service started but without running server :(

What is the meaning of status=4/ILL?

With kind regards Bernd

P.S.: the same with immich V1.60.0

there currently is not typesense package for archlinux. if you want to run typesense in a container you can use immich with typesense until there is a package available.

pkgrel should be set to 1.