Immich PostgreSQL

Immich PostgreSQL is a PostgreSQL database container purpose-built to power the Immich self-hosted photo and video gallery.

  • Databases
Immich PostgreSQL is a PostgreSQL database container purpose-built to power the Immich self-hosted photo and video gallery. It stores and indexes the metadata and media information behind Immich so the main application can search and retrieve your photos and videos quickly and reliably. It is intended for homelab users who self-host Immich and prefer the database container from Immich's official stack over configuring a generic PostgreSQL server.

Platform availability

Available on 2 of 10 platforms

  • Unraid (not listed)
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • 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.

66/100 Good

Maintained
100last commit 3 days ago
Popular
3986 GitHub stars
Easy to install
150 install platforms, install notes
Light to run
No data
Security check
85no serious findings, CI

Based on 4 of 5 factors.

GitHub stars
86
Open issues
6
Last commit
2026-11-18
License
AGPL-3.0
Activity
rising

Checked 2 days ago - source: GitHub (immich-app/base-images)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Set your Immich address and API key In the config.yaml (settings) file, set immich_url to your Immich server address and immich_api_key to the access key Immich gives you; without these, the kiosk can't pull your photos. source
  • Create the config folder first Make a config folder and download the example config.yaml into it before starting the container; this file holds the settings the kiosk needs to run. source
  • Start it in the background Run docker compose up -d in the kiosk folder; the -d flag keeps the container running in the background instead of tying it to your open terminal. source

Fetched 53 days ago - each note links to its source

Alternatives (12)

  • ChronoFrame - ChronoFrame is a self-hosted photo gallery for homelab users who want a private, low-maintenance place to upload, organize, and share perso…
  • 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…
  • 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

How should I handle the PostgreSQL data folder when moving or backing up Immich?

Copy the PostgreSQL data folder from the container to a mounted host directory.

What can happen if PostgreSQL data is not persisted across a Docker deployment?

A user reported that Immich forgot about 100 GB of photos and asked them to register again after an update.

What happened to the database when a TrueNAS user migrated Immich from 24.04 to 24.10?

The PostgreSQL database did not carry over, so the app started with an empty database.

What storage failures should self-hosters consider for long-term Immich data?

Bitrot and hard disk failure are raised as concerns for long-term reliable usage.

Answers sourced from forums.truenas.com, www.reddit.com, www.reddit.com, www.reddit.com

Community

Collected 48 days ago - public community threads