Back to appsSubmit
immich-postgres

immich-postgres

Docker app from sgraaf's Repository

Overview

PostgreSQL 14 database for Immich, pre-built with the VectorChord / pgvecto.rs vector extensions that Immich requires. This is the "database" service from the official Immich docker-compose.yml. It must be on the same custom Docker network ("immich") as the Immich server so the server can reach it by the container name "immich-postgres". POSTGRES_PASSWORD here must match DB_PASSWORD in the immich-server container. NOTE: changing the username/database/password after first start has no effect because the data directory is already initialized.

Runtime arguments

Network
immich
Extra Params
--shm-size=128m

Template configuration

Database passwordVariable

Password for the Postgres database. MUST match DB_PASSWORD set in the immich-server container. Use only A-Za-z0-9 characters.

Target
POSTGRES_PASSWORD
Database userVariable

Postgres username. MUST match DB_USERNAME in immich-server.

Target
POSTGRES_USER
Default
postgres
Value
postgres
Database nameVariable

Postgres database name. MUST match DB_DATABASE_NAME in immich-server.

Target
POSTGRES_DB
Default
immich
Value
immich
Init argsVariable

Arguments passed to initdb on first start. Leave as --data-checksums.

Target
POSTGRES_INITDB_ARGS
Default
--data-checksums
Value
--data-checksums
DB storage type (HDD)Variable

Optional. Set to HDD if the database data is NOT stored on an SSD. Leave blank for SSD.

Target
DB_STORAGE_TYPE
Database dataPathrw

Postgres data directory. Equivalent to DB_DATA_LOCATION in the compose .env file. Keep this on fast/SSD storage. Do NOT use a path that is also handled by another mover/backup process that locks files.

Target
/var/lib/postgresql/data
Default
/mnt/user/appdata/immich/postgres
Value
/mnt/user/appdata/immich/postgres

Categories

Tools > UtilitiesOther

Links

TemplateSupportRegistryProject

Details

Repository
ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
Registry
https://github.com/immich-app/base-images/pkgs/container/postgres
Last Updated2026-06-01
First Seen2026-05-25

Run immich-postgres on Unraid.

immich-postgres is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS