OpenSource-Hub
I

Immich

SHA-256
100.4k stars·Privacy Protection·SHA-256 checksum verified

High performance self-hosted photo and video management solution with automatic backup, AI search, facial recognition, and multi-user support.

Your private, self-hosted Google Photos alternative with AI features.

Core Features

  • Automatic mobile backup for photos and videos
  • AI-powered search (objects, faces, text via CLIP)
  • Facial recognition and clustering
  • Multi-user support and shared albums
  • Supports RAW, LivePhotos, 360-degree images

What It Can't Do

  • Always follow 3-2-1 backup strategy; immich is not a substitute for offsite backups. 2. Carefully configure external volume mounts to avoid data loss. 3. AI features require decent CPU/GPU; low-end hardware may be slow. 4. If using a reverse proxy, ensure WebSocket and file upload size limits are set correctly. 5. No free unlimited storage; monitor disk space regularly.

Use Cases

  • Replace Google Photos or iCloud Photos with full data sovereignty
  • Family or small team media sharing without third-party cloud
  • Photographers managing and backing up RAW files with EXIF metadata

Detailed Introduction

Immich is an open-source, self-hosted photo and video management platform designed to give you full control over your media. It offers automatic backup from mobile devices, powerful AI-powered search (objects, faces, text via CLIP), facial recognition and clustering, shared albums, multi-user support, and a timeline-based interface. It supports raw formats, LivePhotos, 360-degree images, and provides both mobile and web clients. Unlike cloud services, your data stays on your own infrastructure, ensuring privacy and ownership.

Troubleshooting & FAQ (1)

Troubleshooting
Why are the ENCODED_VIDEO_LOCATION and THUMB_LOCATION environment variables not taking effect in Immich?

These environment variables are not read by the Immich server code. They are only intended for variable substitution in the docker-compose.yml to simplify volume mount paths. To actually use custom storage locations, update the volume mounts for the relevant containers to map your desired host directories to the expected internal paths (e.g., mount /your/custom/thumbs to /usr/src/app/upload/thumbs). Refer to the official custom-locations guide for examples.

GitHub Issue #28824

Tags

self-hostedphoto-managementvideo-managementbackupAI-searchfacial-recognition

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Prepare a Linux server (or NAS) with Docker and Docker Compose installed

4

Step 2: Download docker-compose.yml and .env from the official repo, customize storage paths and settings

5

Step 3: Run `docker compose up -d` to start all services

Install Guide
  1. Step 1: Prepare a Linux server (or NAS) with Docker and Docker Compose installed
  2. Step 2: Download docker-compose.yml and .env from the official repo, customize storage paths and settings
  3. Step 3: Run `docker compose up -d` to start all services
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

ae3a662c7b32fe090d4eed35c4fc8586f5d1faa41a252b401aa1581b0dca97e6

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Navigate to the directory containing docker-compose.yml and run `docker compose down -v` (omit -v to preserve database volumes). Then delete the immich folder.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseAGPL-3.0
Last Updated2026-06-27 11:15:23
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects