Arch Linux User Repository

PostgreSQL 18 is coming to the Arch repos. Before upgrading, backup the files for vectorchord and pgvector somewhere, and then follow https://wiki.archlinux.org/title/PostgreSQL#Upgrading_PostgreSQL instructions. (In the next release, I'll also update the postinstall message to recommend changing postgresql.conf instead of doing ALTER SYSTEM SET.)

Also, you may find yourself updating VectorChord in this process. When doing so, remember to follow the migration steps at https://docs.immich.app/administration/postgres-standalone/#updating-vectorchord .

immich-web (localhost/immich-server:2283) used to be broken for some users of this package.

As @yparitcher also noticed, this was most likely caused by the following additions to .gitignore from f4e0aad2c495, which have since be reverted:

src/
pkg/
*.pkg.tar.zst
LICENSES/

The reason—for both this change sometimes and unpredictably breaking the build, and builds under a clean chroot still working—is unknown. I meant to investigate this on 2025-08-19 while updating the package but called it a day due to the unpredictability and long time of building. Help with figuring out why this happened would be greatly appreciated.

You may notice pacman refuse to upgrade this package, saying warning: cannot resolve "vectorchord", a dependency of "immich-server".

This is due to required manual intervention within the immich server database.

Newer versions of immich server have deprecated pgvecto.rs in favor of vectorchord.

Before updating from 1.133.1 or older, please follow steps 1 and 2 of the manual migration steps (should be the second dropdown) at https://immich.app/docs/administration/postgres-standalone/#migrating-to-vectorchord and uninstall pgvecto.rs.

Remember to remove references to "vectors.so" (which is shipped by pgvecto.rs) in shared_preload_libraries before pgvecto.rs in uninstalled. (For vectorchord to work, you'll need to add "vchord.so" to shared_preload_libraries after the upgrade as well.)

After that, you may upgrade this package. Please remember to follow steps 4 and 5 of the manual migration steps after the upgrade is finished to prevent data loss.

(I fixed the checksums yesterday, too. Happy thanksgiving and a merry new- month!)

@CountMurphy in my case, the admincodes files failed also. After fixing the checksums it worked all right, so no big deal.

Happy thanksgiving (if you're state side). I come bearing bad news: cities500.zip is failing checksum

There's groundwork in 2.3.0 on a plugin-based architecture which modifies the installation instructions. I'll hopefully finish this tomorrow night.

Note that the update-checker bug does not affect the mobile app, so use that in the meantime ig.

Edit: Okay, I didn't see @cebtenzzre's edit, but still I don't have enough time today.

There's a pretty serious bug in v2.2.3 that causes the web interface to lock up if there is an update (which triggered when v2.3.0 came out).

v2.3.1 provides the fix, everyone should update to it immediately: https://github.com/immich-app/immich/releases/tag/v2.3.1

patch which worked for me:

diff --git a/PKGBUILD b/PKGBUILD
index 4524f47..5444888 100644
--- a/PKGBUILD
+++ b/PKGBUILD
@@ -6,13 +6,14 @@
 pkgbase=immich
 pkgname=('immich-server' 'immich-cli')
 pkgrel=1
-pkgver=2.2.3
+pkgver=2.3.1
 pkgdesc='Self-hosted photos and videos backup tool'
 url='https://github.com/immich-app/immich'
 license=('AGPL-3.0-only')
 arch=(x86_64)
 # ts-node required for CLI
-makedepends=('git' 'pnpm' 'jq' 'ts-node')
+# mise required for building plugins
+makedepends=('git' 'pnpm' 'jq' 'ts-node' 'mise')

 # combination of server/CLI deps, see split package functions
 # for individual deps and commentary
@@ -72,7 +73,7 @@ source=("${pkgbase}-${pkgver}.tar.gz::https://github.com/immich-app/immich/archi
         'https://download.geonames.org/export/dump/admin1CodesASCII.txt'
         'https://download.geonames.org/export/dump/admin2Codes.txt'
         'https://raw.githubusercontent.com/nvkelso/natural-earth-vector/v5.1.2/geojson/ne_10m_admin_0_countries.geojson')
-sha256sums=('aa7fe92d8ff38a97de8d1252c1e73d2c1cbd32cac5796dade2c4648bbca7557c'
+sha256sums=('20bd60862447e7e369189f9390f8e013b50101cf2fb7561ed47793bcb63c6cc8'
             '475291c45ec0a20b52f7ff927ddd7299f6f9e848e01145817066ff194cd50f07'
             'SKIP'
             'f7821053ceb6f0cf3a2b9a53b7795a7c56a74d3e0239ac38fa734642e9faf833'
@@ -127,6 +128,17 @@ build() {
     rm cli/LICENSE  # deploy would've picked this up, duplicating standard /usr/share/licenses/spdx/AGPL-3.0-only
     pnpm --filter @immich/cli build
     pnpm --filter @immich/cli --prod --no-optional deploy output/cli-pruned
+
+    # build plugins
+    cd plugins
+    export MISE_TRUSTED_CONFIG_PATHS="${PWD}/mise.toml"
+    export MISE_TRUST_PROMPT=false
+    # Install tools via mise (extism CLI, binaryen, etc.)
+    mise install
+    # Install pnpm dependencies for plugins (mise run build will also do this, but ensure workspace is available)
+    pnpm install --frozen-lockfile
+    # Build plugins (mise run build runs: pnpm run build)
+    mise run build
 }

 package_immich-server() {
@@ -154,6 +166,11 @@ package_immich-server() {
     install -dm755 "${pkgdir}/usr/lib/immich/build"
     cp -r web/build "${pkgdir}/usr/lib/immich/build/www"

+    # install corePlugin
+    install -dm755 "${pkgdir}/usr/lib/immich/build/corePlugin"
+    cp -r plugins/dist "${pkgdir}/usr/lib/immich/build/corePlugin/dist"
+    install -Dm644 plugins/manifest.json "${pkgdir}/usr/lib/immich/build/corePlugin/manifest.json"
+
     cd "${srcdir}"

     # install reverse-geocoding data

Hi there, I finally ended up rebuilding the database, but I now understand how this thing with the postgres libraries work. Now I think I'll be ready for the next db upgrade. Thanks everyone!

I can see that. :) I'm trying now to understand how to adjust that so that makepkg -si can take some environment variable or setting into account. EDIT: figured that one out. edited original post. another error follows about tsconfig.json but it may not be critical.

Looks like you simply ran out of memory allocation: https://stackoverflow.com/questions/38558989/node-js-heap-out-of-memory

For me, this is thrown during the web build, which results in a broken webclient UI that doesn't load. This is, however, using yay, so I'll retry with a manual package build and install. EDIT: manual package build also fails with same EDIT: this error was rectified by executing: export NODE_OPTIONS=--max-old-space-size=4096 before makepkg -si

<--- Last few GCs --->
│ [74890:0x55e521122000]    59003 ms: Mark-Compact (reduce) 1912.2 (1928.8) -> 1908.6 (1925.8) MB, pooled: 0.0 MB, 32.15 / 0.08 ms (+ 2317.2 ms in 1093 steps since start of marking, biggest step 109.0 ms, walltime since start of marking 2506 ms) (average mu
│ FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory
│ ----- Native stack trace -----
│  1: 0x55e5191e8745 node::OOMErrorHandler(char const*, v8::OOMDetails const&) [node]
│  2: 0x55e519769144  [node]
│  3: 0x55e51976924b  [node]
│  4: 0x55e5199f451c  [node]
│  5: 0x55e5199fa906  [node]
│  6: 0x55e5199faa17  [node]
│  7: 0x55e519a0a2c4  [node]
│  8: 0x55e519a0d714  [node]
│  9: 0x55e51a481347  [node]
│ 10: 0x55e519a0ac48  [node]
│ 11: 0x55e519a0f415  [node]
│ 12: 0x55e519508b39 node::PerIsolatePlatformData::RunForegroundTask(std::unique_ptr<v8::Task, std::default_delete<v8::Task> >) [node]
│ 13: 0x55e51950b598 node::PerIsolatePlatformData::FlushForegroundTasksInternal() [node]
│ 14: 0x7fcd7b766ec3  [/usr/lib/libuv.so.1]
│ 15: 0x7fcd7b7860a1  [/usr/lib/libuv.so.1]
│ 16: 0x7fcd7b76d5a2 uv_run [/usr/lib/libuv.so.1]
│ 17: 0x55e51931fdd3 node::SpinEventLoopInternal(node::Environment*) [node]
│ 18: 0x55e5194c14ba node::NodeMainInstance::Run(node::ExitCode*, node::Environment*) [node]
│ 19: 0x55e5194c1aed node::NodeMainInstance::Run() [node]
│ 20: 0x55e5193f8ee0 node::Start(int, char**) [node]
│ 21: 0x7fcd79e27675  [/usr/lib/libc.so.6]
│ 22: 0x7fcd79e27729 __libc_start_main [/usr/lib/libc.so.6]
│ 23: 0x55e51931b955 _start [node]
└─ Failed in 1m 29.3s at /home/######/.cache/yay/immich/src/immich-2.2.3/web
/home/######/.cache/yay/immich/src/immich-2.2.3/web:
 ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL  immich-web@2.2.3 build: `vite build`
Command failed with signal "SIGABRT"

@caoticofanegas copy the files listed under pacman -Ql vectorchord and pacman -Ql pgvector under the relevant directories under /opt/pgsql-17