immich README

The project's README from github.com/immich-app/immich. As one markdown file: README.md.


License: AGPLv3 Discord

High performance self-hosted photo and video management solution



Català Español Français Italiano 日本語 한국어 Deutsch Nederlands Türkçe 简体中文 正體中文 Українська Русский Български Português Brasileiro Svenska العربية Tiếng Việt ภาษาไทย മലയാളം

[!WARNING] ⚠️ Always follow 3-2-1 backup plan for your precious photos and videos!

[!NOTE] You can find the main documentation, including installation guides, at https://immich.app/.

Demo

Access the demo here. For the mobile app, you can use https://demo.immich.app for the Server Endpoint URL.

Login credentials

Email Password
[email protected] demo

Features

Features Mobile Web
Upload and view videos and photos Yes Yes
Auto backup when the app is opened Yes N/A
Prevent duplication of assets Yes Yes
Selective album(s) for backup Yes N/A
Download photos and videos to local device Yes Yes
Multi-user support Yes Yes
Album and Shared albums Yes Yes
Scrubbable/draggable scrollbar Yes Yes
Support raw formats Yes Yes
Metadata view (EXIF, map) Yes Yes
Search by metadata, objects, faces, and CLIP Yes Yes
Administrative functions (user management) No Yes
Background backup Yes N/A
Virtual scroll Yes Yes
OAuth support Yes Yes
API Keys N/A Yes
LivePhoto/MotionPhoto backup and playback Yes Yes
Support 360 degree image display No Yes
User-defined storage structure Yes Yes
Public Sharing Yes Yes
Archive and Favorites Yes Yes
Global Map Yes Yes
Partner Sharing Yes Yes
Facial recognition and clustering Yes Yes
Memories (x years ago) Yes Yes
Offline support Yes No
Read-only gallery Yes Yes
Stacked Photos Yes Yes
Tags No Yes
Folder View Yes Yes

Translations

Read more about translations here.

Translation status

Repository activity

Activities

Contributors

immich (immich-app/immich)

Searching Database…

116.4K ·GitHub
What is this?Immich is a self-hosted platform for backing up, organizing and browsing your photos and videos, built as an open-source alternative to Google Photos.
Is this a single app or a server plus client apps?It is a self-hosted backend server paired with client apps: a mobile app (iOS/Android, built with Flutter) for automatic backup, and a web app (SvelteKit) for browsing, sharing and admin tasks.
How do I get Immich running?Follow the official installation guide to deploy the Immich server on your own machine, then enter your server's endpoint URL in the mobile app and log in with your account.
What do I need before installing it myself?You need a machine to self-host the server component; the mobile client just needs the app installed and your server's endpoint URL configured.
Can I rely on Immich as my only backup?No — the project explicitly warns to keep following a proper 3-2-1 backup plan for your photos and videos instead of relying solely on Immich.
Which devices does Immich run on?The mobile app supports iOS and Android (Flutter), while the server and web interface are self-hosted and accessed through any browser.
How is Immich different from just using Google Photos?Immich is self-hosted, so your library stays on your own server instead of Google's cloud, while still offering comparable features like facial recognition, maps and smart search.
Does it support facial recognition and smart search?Yes, the feature table lists facial recognition and clustering, plus search by metadata, objects, faces and CLIP embeddings for both web and mobile.
Can I try it before setting up my own server?Yes, there is a public demo you can log into with [email protected] / demo, and the mobile app lets you point its Server Endpoint URL at the demo server.
Can multiple people share one Immich instance?Yes, it supports multi-user accounts, partner sharing, and shared or public albums according to its feature list.
Creator
immich-app
Size
311.3 MB
Stars
116.4K
Age
4y
Commits · 90 Days