The ultimate self-hosted alternative to Google Photos.
T

The ultimate self-hosted alternative to Google Photos.

The ultimate self-hosted alternative to Google Photos.

104,792 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Immich: The Self-Hosted Google Photos Alternative You Can Actually Trust

Remember the feeling of scrolling through years of photos, only to remember that your cloud storage is filling up, your privacy is a question mark, and you're paying a monthly fee for the privilege? For developers and tinkerers, there's always been a nagging thought: "I should host my own photos." But the complexity of setting up a reliable, full-featured system was a huge barrier. Enter Immich.

Immich is an open-source project that directly tackles that problem. It’s a high-performance self-hosted photo and video backup solution from your mobile phone, designed with one clear goal: to be a genuine, user-friendly alternative to services like Google Photos. It’s built by people who were tired of the trade-offs and decided to build exactly what they wanted.

What It Does

In simple terms, Immich gives you a personal Google Photos-like experience on your own hardware. You install its server component (a Docker container) on a machine you control—a home server, a NAS, or even a Raspberry Pi. Then, you use the Immich mobile app (iOS/Android) or web client to automatically back up your camera roll, view your library, create albums, and share memories. Your data never leaves your network unless you want it to.

Why It's Cool

This isn't just another basic photo gallery. Immich gets the details right, which is what makes it stand out:

  • True Incremental Backup: The mobile app uploads only what's new. No re-uploading your entire library after a reinstall.
  • Machine Learning On-Premise: One of its killer features is the optional integration of TensorFlow for object, face, and scene recognition. All that "smart search" happens locally on your server. You can search for "beach," "dog," or "Aunt Sally" without sending a single image to a third-party API.
  • Metadata & RAW Support: It preserves EXIF data, supports a ton of RAW image formats from DSLRs, and even handles Live Photos and motion photos from iOS and Android.
  • Developer-Friendly Stack: It's built with TypeScript, Node.js, and PostgreSQL. The codebase is modern and active, making it a great project to contribute to or learn from if you're into full-stack development.
  • Roadmap-Aligned Vision: The project maintainers are transparent and focused, actively working on features like partner sharing, advanced user management, and improved video handling. It feels like a product, not just a hobby project.

How to Try It

The easiest way to get started is with Docker and Docker Compose. If you have those installed, you can be up and running in minutes.

  1. Clone the repository to get the docker-compose.yml file:
    git clone https:

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Dec 28, 2025