Skip to content
Get started

Immich on a VPS

Photo and video storage

Install on a VPSGitHub
Category
Cloud / Storage
Hosting
Your own cloud
Author
Immich
License
AGPL-3.0
Version
3.2.4

The script is free · VPS from $13.30 per month · installs in about 5 minutes

Install over SSH

root@vps:~# command -v docker >/dev/null || curl -fsSL https://get.docker.com | sh; mkdir -p /opt/immich && cd /opt/immich && 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 && sed -i "s/^DB_PASSWORD=.*/DB_PASSWORD=$(openssl rand -hex 16)/" .env && docker compose up -d

  • SystemUbuntu 24.04 · x86_64ok
  • Sourcegithub.com/immich-app/immichok
  • Version3.2.4ok
  • Port2283/tcplisten

✓ Immich 3.2.4 installed · about 5 minutes

root@vps:~#

Install command from the library. Output is shortened and may differ on your server.

What it is

  • Photos
  • Video
  • Backup
  • Face recognition

Immich is a self-hosted Google Photos replacement. The mobile app automatically uploads photos and videos, and the web interface shows a timeline, albums and a map.

Built-in machine learning recognizes faces and finds photos by description ("dog on the beach"), all running locally without sharing photos with third parties.

Immich runs via Docker Compose: server, machine learning, PostgreSQL and Valkey. Recognition needs extra memory headroom.

  • Auto-upload of photos and videos from iOS and Android
  • Face recognition and smart search by description
  • Albums, sharing and partner sharing
  • Photo map and metadata
  • Multi-user support

Recommended plan

For Immich: at least 4 vCPU, 8 GB RAM and 150 GB NVMe.

Minimum to run
2 vCPU · 6 GB RAM · 30 GB disk
Systems
Ubuntu 22.04 · Ubuntu 24.04 · Debian 12

How to install

Three steps in the bot or one command over SSH; installation takes about 5 minutes.

  1. 01

    Choose a plan in the bot

    Open @ExpressHost_bot and pay for a VPS. The server will be ready in about 60 seconds.

  2. 02

    Add Immich

    At the “Add-ons” step pick the script from the library, or run it later: Server settings → Scripts.

  3. 03

    Open http://SERVER-IP:2283 and create an administrator

    The bot will send the server address and login details to the chat.

Manually over SSH

Connect to the server as root and run the command. Supported systems: Ubuntu 22.04, Ubuntu 24.04, Debian 12.

Install command
command -v docker >/dev/null || curl -fsSL https://get.docker.com | sh; mkdir -p /opt/immich && cd /opt/immich && 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 && sed -i "s/^DB_PASSWORD=.*/DB_PASSWORD=$(openssl rand -hex 16)/" .env && docker compose up -d

Ports

Immich ports
PortProtocolPurpose
2283tcpWeb interface and API for apps

After installation

  1. 1.Open http://SERVER-IP:2283 and create an administrator
  2. 2.Install the Immich app on your phone, enter the server address and enable auto-upload
  3. 3.For access via a domain, set up an HTTPS proxy to port 2283

Immich FAQ

Didn’t find an answer? Message @ExpressHost_SupportBot.

Which plan do I need?

The Immich documentation requires at least 2 cores and 6 GB RAM and recommends 4 cores and 8 GB. Size the disk to your photo collection.

How do I update Immich?

Run cd /opt/immich && docker compose pull && docker compose up -d. Read the release notes before updating: docker-compose.yml sometimes changes.

Where are the photos stored?

In /opt/immich/library, the database in /opt/immich/postgres. Back up both folders.

Immich installs at checkout — in the bot.

Order a VPS for ImmichBuy in Telegram