Immich VectorChord DB Unofficial

An experimental PostgreSQL 18.3 database container bundling the VectorChord 1.1.1 and pgvector 0.8.2 extensions, designed to replace Immich's standard…

  • Databases
  • Tools & Utilities
An experimental PostgreSQL 18.3 database container bundling the VectorChord 1.1.1 and pgvector 0.8.2 extensions, designed to replace Immich's standard Postgres database. VectorChord, the successor to pgvecto.rs, uses RaBitQ compression for fast, disk-efficient vector search that Immich relies on for face recognition and CLIP-based image search. The image ships with an SSD-optimized configuration tuned from Immich's defaults, so it works best on SSD-backed storage.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

54/100 Fair

Maintained
52last commit 212 days ago
Popular
651,835 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
206 GB minimum RAM, runs on ARM
Security check
90no serious findings, CI

Availability: platform listings confirmed today, links checked 47 days ago

GitHub stars
1,835
Open issues
17
Last commit
2026-04-23
Latest release
1.1.1
Activity
stale

Checked 19 days ago - source: GitHub (tensorchord/VectorChord)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Create the config file Make a folder called config and download the example config.yaml into it, because that file tells the Kiosk what to show. If you don't have it, the app starts with no settings and won't know your Immich server. source
  • Fill in your Immich connection In config.yaml, set immich_url to your Immich server address and immich_api_key to the key from your Immich settings. Without a valid key and URL, the Kiosk can't read your photos and the screen will stay empty. source
  • Start the Kiosk container After saving config.yaml, run docker compose up -d to start the Kiosk in the background. If you skip this step, the container never launches and the Kiosk won't appear. source
  • SSD vs HDD tuning This template ships with SSD-tuned settings (effective_io_concurrency=200, random_page_cost=1.2). If your database runs on an HDD, remove these two parameters from the Post Arguments to fall back to PostgreSQL defaults. source

Fetched 37 days ago - each note links to its source

Alternatives (12)

  • Ente Photos - Open-source, end-to-end encrypted backup and sharing for photos and videos, with multi-platform sync, original quality, privacy controls, a…
  • Frameleaf Manager - Frameleaf Manager is the guided installer and upgrade tool for the self-hosted Frameleaf photo and video library.
  • Go-vod - Go-vod is a minimal, self-hosted video transcoding server for the Memories Nextcloud photo app that exposes stored media as HTTP Live Strea…
  • Google Photos - Cloud storage offering 15 GB free space, automatic album and duplicate organization, AI editing, cross-platform sharing, and secure backups.
  • HomeGallery - HomeGallery is a self-hosted, open-source web gallery for browsing personal photos and videos while keeping your original file and folder s…
  • PhotoPrism - PhotoPrism is a self-hosted, AI-powered photo and video manager.
  • Piwigo - Piwigo is a self-hosted, open-source photo gallery for the web that lets you publish, organise, and share your picture collection with powe…
  • Proton Drive - Emphasizes privacy with end-to-end encryption, Proton Drive safely stores, synchronizes, and shares files across devices via web and mobile…
  • TinyCld - Open source suite for mail, calendar, drive, and contacts with self-hosting, privacy, zero cost, open standards, versioned files, and unifi…
  • foldergram - Foldergram is a self-hosted, local-first web gallery that scans folders for photos and videos and displays them in a fast, Instagram-style…
  • immich-server
  • librephotos - LibrePhotos is a self-hosted, open-source photo management service for organizing and browsing photo and video collections.

Checked 40 days ago - source: AlternativeTo

Common questions

Is this template the official Immich Postgres image?

No, it is an experimental template built on PostgreSQL 18.3 with VectorChord 1.1.1 and pgvector 0.8.2. The official Immich image is a different Postgres image.

What should I change if my Immich database is on an HDD?

Remove effective_io_concurrency=200 and random_page_cost=1.2 from the Post Arguments so PostgreSQL uses its defaults.

How can I recover a broken Immich 1.9.5 setup on unRAID caused by Postgres configuration?

Use the unRAID-specific fix by changing the Postgres instance instead of following Docker Compose instructions.

Is VectorChord the successor to the older pgvecto.rs extension?

Yes, VectorChord is described as the successor to pgvecto.rs and was developed by the same team.

What ongoing database care matters for Immich vector indexes?

Keep vector indexes healthy with autovacuum and reindexes. Be careful with Postgres major version jumps because the database is where Immich upgrades can bite.

Answers sourced from ca.unraid.net, github.com, www.bigiron.cc, www.reddit.com

Community

Collected 53 days ago - public community threads