Self-host Immich
v3.4.1High-performance self-hosted photo and video management
- 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)
ghcr.io/immich-app/immich-serverWhat 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
librephotosSelf-hosted, open-source photo library that indexes the folders you already have with face clustering, places, captions and natural-language search.Comparelibrephotos with Immich
Immich DropSelf-hosted, open-source web app that collects photos and videos from guests through public invite links and uploads them straight into your Immich server.CompareImmich Drop with Immich
PhotoviewPhotoview is a self-hosted, open-source photo gallery organizing photos from your filesystem with RAW support, EXIF metadata, face recognition, and multi-user sharing.ComparePhotoview with Immich
immich-power-toolsSelf-hosted, open-source companion app for Immich: bulk people merges, album suggestions, missing-location fixes, date offsets, analytics and natural-language search.Compareimmich-power-tools with Immich
immich-swipeImmich Swipe is a self-hosted, open-source web app for reviewing Immich libraries with a swipe interface — right to keep, left to delete — installable as a PWA.Compareimmich-swipe with Immich
immich-public-proxySelf-hosted proxy that safely shares Immich photos and albums without exposing your Immich server to the internet, with optional visitor uploads.Compareimmich-public-proxy with Immich
PhotofieldPhotofield is a self-hosted personal photo gallery focused on speed and simplicity for viewing large photo collections locally.ComparePhotofield with Immich
MimickMimick is a self-hosted, open-source GTK4/libadwaita desktop app for Linux that syncs local folders to Immich and provides a library browser.CompareMimick with Immich
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
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.
More in Photo Galleries
immichFrame
Immich KioskSelf-hosted, open-source slideshow for Immich photos on browsers and kiosk devices with extensive customization via Docker, URL params, or YAML config.
Inky Bird FrameInky Bird Frame is a self-hosted, open-source project that turns bird observations into illustrated plates for color e-paper displays and a browser journal.
MemtlySelf-hosted, open-source event photo gallery where guests upload and view photos/videos via QR codes, with admin moderation and multiple database backends.
ownphotosA self-hosted, open-source take on Google Photos built on a Django backend and React frontend, with face recognition, object search, event albums and a map view.
pellicolaPellicola is a self-hosted PHP photo publishing app with EXIF, maps, albums, RSS, and GDPR compliance.
PhotoPrismAI-Powered Photos App 🌈💎✨
PhotoShowPhotoShow is a self-hosted, open-source PHP web gallery for organizing photos with drag-and-drop upload, themes, responsive design, and no database required.
PicImpactOpen-source, self-hosted photo portfolio site with a masonry gallery, Live Photos, WebGL viewer, EXIF and map views, RSS, S3/R2/AList storage, TOTP and passkeys.
Pic-OSelf-hosted photo publishing platform (Laravel 12) with albums, tokenized share links, masonry grid viewer, slideshow, and Docker deployment.
picpeakSelf-hosted photo gallery for photographers to share password-protected, expiring galleries with clients. Includes proofing, guest uploads, and white-label branding.
PicsurPicsur is a self-hosted, open-source image sharing service in the spirit of Imgur, with format conversion, image editing, expiring uploads and a ShareX endpoint.




0 comments