immich-app/immichPublic

What is immich?

A high-performance, self-hosted photo and video backup solution designed as a direct alternative to cloud services.

What does immich do?

Immich is a comprehensive, self-hosted media gallery that provides seamless backup, management, and organization for personal photos and videos. It features dedicated, native mobile applications for background synchronization and a responsive web interface for viewing media across devices. The robust backend utilizes machine learning to perform automatic facial recognition, object detection, and geographical clustering entirely on your own hardware. It is specifically engineered to handle massive media libraries with high performance, efficiently transcoding videos and generating thumbnails for fast loading. It offers users complete data sovereignty and privacy without sacrificing the modern, intelligent features expected from premium cloud services.

Who is immich for?

Built for privacy-conscious individuals, families, and homelab enthusiasts who want a modern, feature-rich photo backup solution running exclusively on their own hardware. Users are expected to have a basic understanding of the relevant underlying technologies.

How do I get started with immich?

Follow the official documentation to deploy the application stack using Docker Compose.

How popular is immich on GitHub?

immich-app/immich has 115,580 stars and 7,133 forks on GitHub, and gained 425 stars in the last 7 days.

What license does immich use?

immich-app/immich is released under the AGPL-3.0 license.

• Landmark project

  115,580 stars

• Very active

  5,007 commits in 52 weeks

• Community-driven

  ~1,015 contributors

• Well documented

  High community health score

• Continuous integration

  Automated checks passing

• Repeat trending

  5 trending appearances

• Top 10% tracked

  Rank 58 of 1135

Immich is a comprehensive, self-hosted media gallery that provides seamless backup, management, and organization for personal photos and videos. It features dedicated, native mobile applications for background synchronization and a responsive web interface for viewing media across devices. The robust backend utilizes machine learning to perform automatic facial recognition, object detection, and geographical clustering entirely on your own hardware. It is specifically engineered to handle massive media libraries with high performance, efficiently transcoding videos and generating thumbnails for fast loading. It offers users complete data sovereignty and privacy without sacrificing the modern, intelligent features expected from premium cloud services.

Built for privacy-conscious individuals, families, and homelab enthusiasts who want a modern, feature-rich photo backup solution running exclusively on their own hardware. Users are expected to have a basic understanding of the relevant underlying technologies.

• Automatic mobile backup: Seamlessly syncs photos and videos in the background using dedicated, native iOS and Android applications.
• On-device machine learning: Automatically detects faces, objects, and locations for advanced search and clustering without sending data externally.
• High-performance media processing: Efficiently transcodes large videos and generates optimized thumbnails to ensure fast, responsive gallery loading.
• Multi-user support: Allows entire families to share a single self-hosted instance while keeping individual media libraries strictly private.
• Data sovereignty: Ensures all personal media and metadata remain entirely on your own self-hosted infrastructure, maximizing privacy.

Getting started: Follow the official documentation to deploy the application stack using Docker Compose.

1. v3.3.0-rc.2v3.3.0-rc.2Oct 2, 2026pre-release466 downloads

   # v3.3.0-rc.2 > \[!WARNING\] > > ## Disclaimer > > This is a **release candidate**, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version. Welcome to the third release candidate of `v3.3`; `v3.3.0-rc.2`! Some more features, person sharing improvements, and bug fixes. This will likely be the last RC before the `v3.3` release. Keep reading below for the draft release notes and instructions on how to run this release candidate. ### Release notes Work-in-progress release notes can be found here: <https://pr-846.dev.immich.app/blog/v3.3.0-release> ### Machine Learning Set `MACHINE_LEARNING_MODEL_REVISION=v2` to take full advantage of the memory usage and performance improvements in this release. ### Server To use this RC version on the server, update the `IMMICH_VERSION` in your `.env` file: ``` IMMICH_VERSION=v3.3.0-rc.2 ``` or ``` IMMICH_VERSION=v3-rc ``` Then pull and restart: ```bash docker compose pull && docker compose up -d ``` ### Mobile To use this RC version on the mobile app, follow

2. v3.3.0-rc.1v3.3.0-rc.1Sep 30, 2026pre-release719 downloads

   # v3.3.0-rc.1 > \[!WARNING\] > > ## Disclaimer > > This is a **release candidate**, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version. Welcome to the second release candidate of `v3.3`; `v3.3.0-rc.1`! There have not only been bug fixes, but also new features and more person sharing improvements. Keep reading below for the draft release notes and instructions on how to run this release candidate. ### Release notes Work-in-progress release notes can be found here: <https://pr-846.dev.immich.app/blog/v3.3.0-release> ### Machine Learning Set `MACHINE_LEARNING_MODEL_REVISION=v2` to take full advantage of the memory usage and performance improvements in this release. ### Server To use this RC version on the server, update the `IMMICH_VERSION` in your `.env` file: ``` IMMICH_VERSION=v3.3.0-rc.1 ``` or ``` IMMICH_VERSION=v3-rc ``` Then pull and restart: ```bash docker compose pull && docker compose up -d ``` ### Mobile To use this RC version on the mobile app, follow the appropriate link for y

3. v3.3.0-rc.0v3.3.0-rc.0Sep 29, 2026pre-release655 downloads

   # v3.3.0-rc.0 > \[!WARNING\] > > ## Disclaimer > > This is a **release candidate**, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version. Welcome to the first release candidate of `v3.3`; `v3.3.0-rc.0`! Keep reading below for the draft release notes and instructions on how to run this release candidate. ### Release notes Work-in-progress release notes can be found here: <https://pr-846.dev.immich.app/blog/v3.3.0-release> ### Server To use this RC version on the server, update the `IMMICH_VERSION` in your `.env` file: ``` IMMICH_VERSION=v3.3.0-rc.0 ``` or ``` IMMICH_VERSION=v3-rc ``` Then pull and restart: ```bash docker compose pull && docker compose up -d ``` ### Mobile To use this RC version on the mobile app, follow the appropriate link for your platform: #### **Android** You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page <img width="300" alt="image" src="https://github.com/user-attachments/assets/550d5059-bd0b-4a67-94f2-4

4. v3.2.4v3.2.4Sep 28, 202654.9K downloads

   It's been a while since we last had to sacrifice a release. Let's hope v3.2.3 was a good sacrifice for v3.3, which is right around the corner! Just another small patch that primarily fixes the memory leak people have observed through a dependency update. <!-- Release notes generated using configuration in .github/release.yml at v3.2.4 --> ## What's Changed ### 🐛 Bug fixes * fix(mobile): sync status page goes blank when the counts query fails by @immich-push-o-matic[bot] in https://github.com/immich-app/immich/pull/31644 **Full Changelog**: https://github.com/immich-app/immich/compare/v3.2.2...v3.2.4

5. v3.2.2v3.2.2Sep 15, 2026116.4K downloads

   Just another small patch with a fix for the reassign faces feature. <!-- Release notes generated using configuration in .github/release.yml at v3.2.2 --> ## What's Changed ### 🐛 Bug fixes * fix: skip faces of other users when reassigning faces by @immich-push-o-matic[bot] in https://github.com/immich-app/immich/pull/31586 **Full Changelog**: https://github.com/immich-app/immich/compare/v3.2.1...v3.2.2

• freeCodeCamp/freeCodeCamp

  freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.

  456.7K stars · TypeScript

• openclaw/openclaw

  The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

  391.3K stars · TypeScript

• awesome-selfhosted/awesome-selfhosted

  A list of Free Software network services and web applications which can be hosted on your own servers

  323.8K stars

• practical-tutorials/project-based-learning

  Curated list of project-based tutorials

  285.8K stars · Python

• react/react

  The library for web and native user interfaces.

  250.9K stars · JavaScript

• anomalyco/opencode

  The open source coding agent.

  211.7K stars · TypeScript