Computing

How to replace Google Photos with Immich: a self-hosting guide for 2026

Key takeaways

  • Immich is a free, open source (AGPL v3) photo server you run yourself with Docker Compose. Its official minimum is 6GB of RAM and 2 CPU cores, with 8GB and 4 cores recommended.
  • Install it from the docker-compose.yml and example.env attached to the latest GitHub release, keep the Postgres database on a local SSD, and open it on port 2283.
  • immich-go reads Google Takeout zip files directly and restores capture dates, GPS and albums from the JSON sidecars that a plain import would lose.
  • Immich's automatic database dumps contain metadata only, not your photos. Back up the library, upload and profile folders as well, off the machine.
  • Over five years Google's 2TB plan costs £479.40 at £7.99 a month. Self-hosting wins clearly only if you already own suitable hardware.

Immich is a free, open source photo and video server you run on your own computer. It does what Google Photos does, including phone backup, face grouping and search by what is in the picture, but the files and database live on hardware you control.

This guide follows the official Immich and Docker documentation as of October 2026, when the current Immich release was v3.3.1 (8 October 2026). It covers the hardware, the install, moving your library out of Google, backups, and an honest five-year cost comparison in pounds.

What does Immich do, and what do you give up?

Immich has native iOS and Android apps with automatic backup, a web interface, shared albums, a map view, face recognition and smart search. The machine learning that powers faces and search runs in its own container on your server, not in someone else's cloud.

What you give up is someone else doing the operations work. With Google, a failed disk or a broken upgrade is Google's problem. With Immich it is yours: a PostgreSQL database to protect, containers to update, and a backup plan you have actually tested. The Immich FAQ is frank about this, noting that once you count hardware, backup storage and your time, self-hosting rarely saves money.

What hardware do you need to self-host Immich?

The official requirements are:

ItemMinimumRecommendedNotes from the docs
RAM6GB8GB4GB works with machine learning disabled
CPU2 cores4 coresamd64 or arm64
OS64-bit Linux64-bit LinuxNon-Linux hosts "tend to provide a poor Docker experience"
Database diskLocal SSDLocal SSDNever a network share of any kind
Photo storageUnix filesystemEXT4, ZFS or similarThumbnails and transcodes add 10 to 20% to the library size

In practice that points to a small x86 mini PC with an Intel N100 or N150 and 16GB of RAM, an old desktop, or a NAS that runs Docker. A Raspberry Pi 5 with 8GB meets the RAM figure, but the Immich FAQ warns it "can be too heavy" for a Pi; the documented workarounds are disabling machine learning or running the machine learning container on a more powerful machine.

Two storage rules matter more than the computer. Keep the Postgres data directory on a local SSD. And size the photo disk from your actual library: check how much your Google storage page says Photos is using, then add 10 to 20% for thumbnails and room to grow. If you are choosing hardware from scratch, our home server build guide covers cases, drives and power supplies, and choosing a home server OS covers what to run underneath.

How do you install Immich with Docker Compose?

These steps assume Debian or Ubuntu on the server. Immich requires the docker compose command (Compose v2); the old docker-compose tool is no longer supported.

1. Install Docker Engine. Docker's convenience script is the quickest route on a home server. Docker's own docs note it is not recommended for production environments; for a family photo server, the alternative is the apt repository method on the same page.

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo docker run hello-world

2. Download the compose file and environment file from the latest release. Do not write these by hand. The project changes service definitions between releases.

mkdir ./immich-app
cd ./immich-app
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

3. Edit .env. Four values matter:

UPLOAD_LOCATION=/srv/immich/library
DB_DATA_LOCATION=/srv/immich/postgres
TZ=Europe/London
DB_PASSWORD=ChangeMeToALongRandomString

UPLOAD_LOCATION is where photos and videos are stored. DB_DATA_LOCATION must be on the local SSD. TZ is commented out by default, so remove the # in front of it. For DB_PASSWORD, the docs recommend only the characters A to Z, a to z and 0 to 9, because other characters can break Docker's parsing. pwgen 32 1 generates a suitable one.

4. Start it.

docker compose up -d

5. Create the admin account. Open http://<server-ip>:2283 in a browser and click Getting Started. The first account registered becomes the administrator. Then install the Immich app on your phone, enter the same address as the server URL, sign in and turn on backup.

Do not forward port 2283 on your router. For access away from home, use a VPN such as WireGuard or Tailscale, or a reverse proxy with TLS. If you are not sure what your network already exposes, here is how to check if your server is exposed to the internet.

How do you know it worked?

  • docker compose ps lists the Immich server, machine learning, Postgres and Redis containers as running.
  • The web page loads on port 2283 and lets you sign in.
  • A test photo from your phone appears in the web timeline, and after the jobs finish, the Explore page starts showing people and places.

How do you move your library out of Google Photos?

Google Takeout is the official export. Choose Google Photos only, pick the 50GB archive size to reduce the number of files, and download promptly: Google's help page says archives expire after about seven days and each one can be downloaded five times.

The catch is that Takeout puts dates, locations and album membership in separate JSON files next to each photo. Upload the image files on their own and many will appear on the date you exported them. immich-go, an independent open source command line tool, reads the Takeout zip files directly and matches each photo to its JSON. Its documentation says it restores the original capture date, GPS coordinates and albums. The current release, v0.32.0, added compatibility with Immich v3.

First create an API key in Immich (Account settings, API keys). immich-go's install guide lists the permissions it needs, including asset.upload, asset.read, album.create and user.read; giving the key all permissions is simplest. Then download the binary for your system from the immich-go releases page and run:

immich-go upload from-google-photos --dry-run \
  --server=http://<server-ip>:2283 --api-key=<your-key> /path/to/takeout-*.zip
# then the real upload
immich-go upload from-google-photos \
  --server=http://<server-ip>:2283 --api-key=<your-key> /path/to/takeout-*.zip

The first command reports what it would do without uploading. Defaults worth knowing: albums are synced and archived photos are included, while items in Google's bin are skipped unless you add --include-trashed. Keep the original Takeout zips until you have spot-checked dates, locations and albums on a few hundred photos.

How do you back up Immich properly?

Immich makes an automatic database dump every day at 2am and keeps the last 14, stored in UPLOAD_LOCATION/backups. You can change this under Administration, Settings, Database Dump Settings. The docs are explicit that these dumps "do not contain photos or videos, only metadata."

A usable backup therefore needs two things copied off the machine together: the database dumps, and the original media. Inside UPLOAD_LOCATION, the critical folders are library, upload and profile. The thumbs and encoded-video folders can be regenerated, at the cost of rerunning those jobs after a restore. Our guide to the 3-2-1 backup rule explains how to add an off-site copy.

To test a restore, install Immich fresh in a separate folder, copy your backed-up data into its UPLOAD_LOCATION, start it and choose the restore option on the welcome screen. On a running instance, the restore lives under Administration, Maintenance, Restore database backup, and it wipes the current database. Do this test before deleting anything from Google.

Common problems and fixes

SymptomLikely causeFix
docker-compose: command not foundOld Compose v1Use docker compose (with a space) from Docker Engine
Postgres keeps restartingDatabase on a network share, NTFS or exFATMove DB_DATA_LOCATION to a local Linux filesystem on SSD
Login fails after changing .envPassword contains special charactersUse only letters and numbers in DB_PASSWORD
Phone app will not log inApp and server versions differUpdate both so major and minor versions match
iPhone backs up only when openediOS controls background tasksEnable Background App Refresh, avoid Low Power Mode
Machine is slow for days after importFace and search indexing runningNormal on large libraries; on a Pi, disable machine learning or move it
Photos dated on export dayRaw Takeout files uploaded without JSONRe-import with immich-go upload from-google-photos

Updating and uninstalling

Read the release notes before every upgrade, because the docs ask you to account for breaking changes. Then, in the folder with docker-compose.yml:

docker compose pull && docker compose up -d
docker image prune

If you pinned IMMICH_VERSION in .env, change it first or you will stay on the old version.

To remove Immich, run docker compose down -v, then delete the DB_DATA_LOCATION and UPLOAD_LOCATION folders. That destroys the database and every uploaded file, so copy your originals out first.

Is self-hosting cheaper than Google One in the UK?

Google's UK plans page lists 2TB at £7.99 a month (sold as Google AI Plus in October 2026) and 5TB at £18.99. Annual billing is advertised as saving up to 16%. Over five years of monthly billing, 2TB costs £479.40.

For the self-hosted side, electricity uses Ofgem's price cap rate of 26.32p per kWh for October to December 2026 (Direct Debit, national average). The 12W average draw is an assumption based on ServeTheHome measuring 10.5 to 12W at idle on N100 systems; drives and indexing push it higher. Hardware budgets are illustrative, so swap in your own quote.

Five-year costGoogle 2TBSelf-host, hardware already ownedSelf-host, £250 hardwareSelf-host, £500 hardware
Subscription or hardware£479.40£0£250£500
Electricity, 12W for 5 years (526 kWh)£0£138£138£138
Total£479.40£138£388£638

The arithmetic: 12W for 8,760 hours is 105.1 kWh a year, which at 26.32p is about £27.67 a year. Rates change every quarter, so treat the electricity line as a snapshot. On these numbers the break-even hardware budget is about £340, before you pay for an off-site backup copy, which self-hosting needs and Google includes.

So the money case is strong if you already own a spare machine, roughly level if you buy a modest mini PC, and negative if you buy new premium hardware. The stronger reasons are control: your library is not tied to an account that can be locked or repriced, and it keeps working on your home network when the broadband is down.

Frequently asked questions

Is Immich free?

Yes. Immich is open source under the GNU AGPL v3 licence. The project sells an optional one-time product key to support development, with no monthly fee for self-hosting. You still pay for hardware, electricity and backup storage.

Can Immich run on a Raspberry Pi?

It runs on arm64, so a Raspberry Pi 5 with 8GB can host it, but the Immich FAQ warns it can be too heavy for a Pi. The usual fixes are disabling machine learning or running the machine learning container on a faster computer.

Does Immich keep Google Photos dates and albums?

Only if you import with a tool that reads the Takeout JSON files. immich-go's from-google-photos command restores capture dates, GPS and albums. Uploading the raw files on their own loses that metadata.

Does Immich back up automatically on iPhone?

The iOS app can back up in the background, but iOS decides when apps may run background tasks. Immich suggests enabling Background App Refresh, avoiding Low Power Mode and opening the app regularly.

Last checked against the Immich, immich-go, Docker, Google and Ofgem documentation on 11 October 2026.

More from Future Technology HQ