selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Immich logo

Self-host Immich

v3.4.1

High-performance self-hosted photo and video management

ReleaseOpen SourceAGPL-3.0
Updated4 days ago
LanguageTypescript
Setup difficultyModerate
MobileNative app
Stars
119 288
Rating
4.5 (2)
CPU
2 cores minimum, 4 cores recommended
RAM
6GB minimum, 8GB recommended
Storage
Unix-compatible filesystem (EXT4, ZFS, APFS, etc.) with support for user/group ownership and permissions
Ports
2283 (Immich server HTTP), 3003 (Machine learning service HTTP)
Docker
ghcr.io/immich-app/immich-server
Install with Docker Compose
Immich web interface showing photo gridImmich mobile app interfaceShared albums and partner sharing featureFacial recognition with face detection boxes

What is Immich?

Immich is a self-hosted photo and video management platform that lets you back up, organize, and browse your media library on your own server. It offers native iOS and Android apps for automatic backup, a web interface with facial recognition and CLIP-based semantic search, shared albums and partner sharing, LivePhoto and RAW format support, and administrative tools for multi-user management. The stack runs via Docker Compose with three main services: the Immich server (Node.js/NestJS), a machine learning microservice for AI features, and a PostgreSQL database with vector extensions. Immich is developed by FUTO and licensed under AGPL-3.0.

Immich alternatives

All self-hosted alternatives to Google Photos →

Should you self-host Immich?

Immich scores 93/100 on selfhost.directory (how scoring works) and ranks #1 of 19 in Photo Galleries. It has 119 288 GitHub stars, +3 244 in the last 30 days.

It shipped 25 stable releases in the past year. The latest, v3.4.1, came out on 11 November 2026. New versions land roughly every 5 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Ente (82/100, 30 152 stars). Immich scores higher overall. See Immich vs Ente side by side.

Features

  • 360-degree image display
  • API Keys
  • Archive and favorites
  • Facial recognition
  • Global map view
  • LivePhoto and MotionPhoto support
  • Memories (on this day)
  • Multi-user support
  • Offline support (mobile)
  • Photo and video backup
  • Public sharing links
  • RAW format support
  • Semantic search (CLIP)
  • Shared albums and partner sharing
  • Stacked photos

Immich README

How to install Immich

Install Immich with Docker Compose

Recommended installation method

How to configure Immich

  • IMMICH_VERSIONv3Image tags
  • UPLOAD_LOCATIONHost path for uploads
  • DB_DATA_LOCATIONHost path for Postgres database
  • DB_PASSWORDpostgresDatabase password
  • DB_USERNAMEpostgresDatabase user

Immich releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Does Immich change the original files?

No, Immich does not modify original files. Edited metadata is saved in companion .xmp sidecar files and the database.

Can I add my existing photo library?

Yes, using the External Library feature.

Does Immich support filtering of NSFW images?

No, this is not currently supported. There is an open feature request on GitHub.

Does Immich support reading existing face tag metadata?

Yes, Immich creates new faces and persons from imported asset metadata.

Why is background backup on iOS not working?

iOS controls background task invocation based on multiple factors. Enable Background App Refresh, disable Low Power Mode, and use the app more often to increase likelihood.

Why does foreground backup stop when I navigate away from the app?

Foreground backup and background backup are separate mechanisms that don't communicate. Background tasks are scheduled by the OS based on battery policies.

I cannot log into the application after an update. What can I do?

Verify that the mobile app and server are both running the same version (major and minor). Check mobile logs and try logging in on the web app.

How can I change my profile picture?

View a single photo, press the three dots in the top-right to show context menu, and select Set as profile picture. Zoom and align the picture, then press Save.

How can I see a list of all users in Immich?

Run the list-users command on the immich-server container.

How can I reset the admin password?

Run the reset-admin-password command on the immich-server container.

Models for Immich

Open-weight models you can plug into Immich, most popular first.

facebook logo Classification303MConditions≈1.2 GB↓ 692.2K
openai logo Classification151MCheck licence≈0.8 GB↓ 17.8M
facebook logo Classification86MConditions≈0.7 GB↓ 395.2K
facebook logo Classification22MConditions≈0.6 GB↓ 180.2K
google logo Classification375MCommercial OK≈1.3 GB↓ 1.3M
openai logo Classification428MCheck licence≈1.5 GB↓ 8M
pixai-labs logo Classification486MCommercial OK≈1.6 GB↓ 35.8K
google logo Classification87MCommercial OK≈0.7 GB↓ 15.8M

Browse all 92 models →

More in Photo Galleries

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…