Immich PostgreSQL
Immich PostgreSQL is a PostgreSQL database container purpose-built to power the Immich self-hosted photo and video gallery.
Platform availability
Available on 2 of 10 platforms
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
Variants
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
- r/selfhosted on Reddit: Immich has (optional) breaking changes, please ... (reddit)
- PostgreSQL dont keeps persistent data : r/immich - Reddit (reddit)
- Immich App postgres Database does not migrate from 24.04 to 24.10 (forum)
Collected 48 days ago - public community threads