immich-vectorchord-db-official
ghcr.io/immich-app/postgres:18-vectorchord0.5.3-pgvector0.8.1
https://github.com/immich-app/base-images/pkgs/container/postgres
immich_internal
bash
false
https://github.com/immich-app/immich/issues
https://immich.app
Official Immich PostgreSQL 18 with VectorChord 0.5.3 and pgvector 0.8.1.
This is the official database image from the Immich team with a built-in optimized PostgreSQL configuration (512MB shared_buffers, SSD/HDD auto-tuning, WAL compression). No manual tuning via Post Arguments needed.
SSD vs HDD: Set the DB_STORAGE_TYPE variable to HDD if your database is not on an SSD. Defaults to SSD.
VectorChord is the successor to pgvecto.rs and uses RaBitQ compression for efficient vector search. Immich uses these extensions for face recognition (face_index) and CLIP-based image search (clip_index).
Watch the Immich base-images repo for updates:
Version matrix: https://github.com/immich-app/base-images/blob/main/postgres/versions.yaml
SSD config: https://github.com/immich-app/base-images/blob/main/postgres/postgresql.ssd.conf
HDD config: https://github.com/immich-app/base-images/blob/main/postgres/postgresql.hdd.conf
Tools: Status:Stable
https://raw.githubusercontent.com/rorar/unraid-templates/main/templates/immich-postgres-official.xml
https://raw.githubusercontent.com/rorar/unraid-templates/main/templates/docker_icons/vectorchord-logo.png
--shm-size=128m --health-cmd="pg_isready -U postgres" --health-interval=10s --health-retries=5 --health-start-period=30s --health-timeout=5s
Database files must reside on locally attached storage (SSD/NVMe), not on a remote-mounted filesystem (e.g. NFS/SMB from another machine). Used as the database backend for Immich.
Full setup guide: https://rorar.github.io/immich-unraid-manual/
postgres
postgres
immich
--data-checksums
5432
/mnt/user/appdata/immich-vectorchord-db/
SSD
Europe/Berlin