Skip to content

Self-host Immich

updated Jul 2026prices checked · Aug 2026Install verified on Ubuntu 26.04 · Aug 2026 · how we test

Blazing-fast self-hosted photo and video backup with ML search, faces, and a great mobile app. The Google Photos killer.

Key facts

CategoryPhoto backup & gallery
LicenseAGPL-3.0
StackTypeScript, Node.js
Min RAM4096 MB
Dockeryes
Difficulty
Our recommendation

Choose Immich if you want a genuine Google Photos replacement — fast mobile backup, face and object search, a real timeline — and you can give it a box with proper RAM (ideally a GPU for the machine-learning features). It moves fast: pin a version and read the release notes before every update.

Follow the Immich deploy guide →

What you need

  • Any VPS with at least 4096 MB of RAM
  • A domain you control — most self-hosted setups need HTTPS in front of them
  • About an afternoon — budget time for troubleshooting

Install

Run these commands on your server:

# Immich — official compose + env template
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
# set UPLOAD_LOCATION and DB_PASSWORD in .env, then:
docker compose up -d  #  →  http://SERVER_IP:2283

What you take on

Immich is superb, but it's pre-1.0 software holding your only copy of irreplaceable photos:

non-negotiableIt is still beta. Breaking changes ship regularly — pin an exact image tag, never latest, and read the release notes before you upgrade.
non-negotiableIt is not your backup. Immich manages your library, it doesn't protect it — keep a separate, off-box copy of the originals so a bad migration can never lose a photo.
non-negotiableMachine learning is hungry. Face and smart search want several GB of RAM and are far happier with a GPU; on a small VPS, expect to throttle or disable them.

An alternative to

Head-to-head

More self-hosted tools

Common questions

How much RAM does Immich need?

Immich's listed minimum is 4 GB of RAM — the machine-learning features (face recognition, smart search, object detection) are the main driver of that requirement, more than the file storage itself.

Can I self-host Immich with Docker?

Yes — download the official docker-compose.yml and .env template, set UPLOAD_LOCATION and DB_PASSWORD, then run docker compose up -d to reach it on port 2283.

Is Immich a good Google Photos alternative?

Immich is built specifically to replace Google Photos: automatic mobile backup, a timeline view, and ML-powered search, while keeping every photo on hardware you own under the AGPL-3.0 license.

Is Immich stable enough for daily use?

Immich is still under active, fast-moving development (it's rated mid-difficulty to deploy), so expect frequent updates; back up your library before major version bumps as the project recommends.

We use analytics cookies (Google Analytics, PostHog) to see which guides are useful. No ad networks, no cross-site tracking. See our privacy policy.