Immich Server

Immich is a high-performance, self-hosted photo and video management platform featuring AI-powered organisation, semantic search, and family sharing.

  • AI
  • Backup
  • Cloud
  • Media Applications
  • Media Servers
  • Tools & Utilities
Immich is a high-performance, self-hosted photo and video management platform featuring AI-powered organisation, semantic search, and family sharing. This entry is the main server component from the official Immich Docker Compose stack, running the API, web UI on port 2283, and background worker microservices. It is designed for homelab users seeking a self-hosted alternative to cloud photo services like Google Photos.

Platform availability

Available on 7 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.

86/100 Excellent

Maintained
100last commit 8 days ago
Popular
100119,192 GitHub stars
Easy to install
1007 install platforms, install notes, setup guide, Docker image
Light to run
106 GB minimum RAM

Availability: platform listings confirmed today, links checked 3 days ago

GitHub stars
119,192
Open issues
682
Last commit
2026-11-12
Latest release
v3.4.1
License
AGPL-3.0
Activity
steady

Checked 7 days ago - source: GitHub (immich-app/immich)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s).

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fill in your Immich URL and API key Open the downloaded config.yaml and set immich_url and immich_api_key before starting; without them the kiosk cannot find your photo library and will not show photos. source
  • Keep the config file private Store your finished config in ./config/config.yaml and avoid sharing it; it contains your Immich API key, which could let someone view or change your library. source
  • Start the container in the background Run docker compose up -d to launch the kiosk in the background; this starts the actual web page, and if you skip it nothing will be displayed. source
  • Docker network and start order All four Immich containers (immich-postgres, immich-redis, immich-machine-learning, and immich-server) must share the same user-defined Docker network so they can resolve each other by container name. Start them in this order: immich-postgres and immich-redis first, then immich-machine-learning, then immich-server. source
  • Password configuration The DB_PASSWORD environment variable in the immich-server container must exactly match the POSTGRES_PASSWORD set in the immich-postgres container. source

Fetched 47 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 54 days ago - source: AlternativeTo

Common questions

Does Immich support OAuth?

Yes, Immich supports OAuth on both the mobile app and the web UI.

Can the Immich mobile app back up photos automatically?

Yes, the mobile app supports automatic backup when opened and background backup.

Can I import a Google Photos collection into Immich?

A user reports running immich-go on a Google Photos collection to set up Immich for the first time.

Do I need to rename example.env when installing Immich?

If you download example.env from a browser, rename it to .env before using it with docker-compose.yml.

Can the Immich database be stored on a network share?

No, network shares are not supported for the database; set DB_DATA_LOCATION to a local path such as ./postgres.

Answers sourced from docs.immich.app, github.com, www.reddit.com

Community

Collected 49 days ago - public community threads

Install guides