All apps · 0 apps

immich-postgres

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.

Readme

View on GitHub

PostgreSQL Database Management System

This directory contains the source code distribution of the PostgreSQL database management system.

PostgreSQL is an advanced object-relational database management system that supports an extended subset of the SQL standard, including transactions, foreign keys, subqueries, triggers, user-defined types and functions. This distribution also contains C language bindings.

General documentation about this version of PostgreSQL can be found at https://www.postgresql.org/docs/devel/. In particular, information about building PostgreSQL from the source code can be found at https://www.postgresql.org/docs/devel/installation.html.

The latest version of this software, and related software, may be obtained at https://www.postgresql.org/download/. For more information look at our web site located at https://www.postgresql.org/.

Install immich-postgres on Unraid in a few clicks.

Find immich-postgres in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for immich-postgres Review the template variables and paths Click Install

Explore Unraid OS

Related apps

Explore more like this

Explore all

Utilities apps Other

Links

Projectpostgresql.org Supportgithub.com Registrygithub.com Templateraw.githubusercontent.com

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-07-17

First Seen2026-05-25

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

Library

Curated

Categories