How to Install Immich on Ubuntu 24.04 Using Docker

---

Immich is a high-performance, self-hosted photo and video backup solution designed as a privacy-focused alternative to Google Photos. It supports fast uploads, AI-powered search, face recognition, and a modern web interface.

This guide shows how to install Immich on Ubuntu 24.04 using Docker and Docker Compose.

Prerequisites

---

• Ubuntu 24.04 VPS or Dedicated Server
• Root access or sudo privileges
• Minimum 4 GB RAM recommended
• Open port 2283/tcp

Step 1: Update the System

---

Update and upgrade all system packages.

apt update && apt upgrade -y

Step 2: Install Docker Dependencies

---

Install required system packages.

apt install -y ca-certificates curl

Create the Docker keyrings directory.

install -m 0755 -d /etc/apt/keyrings

Add Docker’s official GPG key.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

Step 3: Add Docker Repository

---

Add the official Docker repository.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo $VERSION_CODENAME) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

Update the package index.

apt update

Step 4: Install Docker and Docker Compose Plugin

---

Install Docker Engine and Docker Compose plugin.

apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Verify installation.

docker --version
docker compose version

Example output:

Docker version 26.1.3, build 26.1.3
Docker Compose version v2.30.3

Step 5: Create Immich Directory

---

Create a working directory for Immich.

mkdir ~/immich
cd ~/immich

Step 6: Download Immich Docker Files

---

Download the latest Docker Compose file and environment 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

Step 7: Configure Immich Environment

---

Edit the environment file.

nano .env

Update the following values.

UPLOAD_LOCATION=/root/immich/uploads
DB_DATA_LOCATION=/root/immich/db
IMMICH_SERVER_PORT=2283
DB_PASSWORD=StrongPassword123

Replace "StrongPassword123" with ypur actual/strong password

Create required directories.

mkdir -p /root/immich/uploads
mkdir -p /root/immich/db

Save and exit the editor.

Step 8: Start Immich Containers

---

Start Immich services in detached mode.

docker compose up -d

Verify containers are running.

docker ps

You should see Immich server, machine learning, Redis, and PostgreSQL containers running.

Step 9: Access Immich Web Interface

---

Open your browser and navigate to:

http://Your-server-IPaddress:2283

You will see the Immich setup page where you can create the admin account.

Step 10: Enable Auto-Start on Reboot (Optional)

---

Edit the root crontab.

crontab -e

Add the following line.

@reboot cd /root/immich && docker compose up -d

Save and exit.

Updating Immich

---

To update Immich to the latest version:

cd ~/immich
docker compose pull
docker compose up -d

Notes

---

• Use a reverse proxy (Nginx / Caddy / Traefik) with HTTPS for production use
• Ensure adequate RAM for AI features and background jobs
• Regularly back up the uploads and database directories

Conclusion

---

You have successfully installed Immich on Ubuntu 24.04 using Docker.
Access it at:

http://Your-server-IPaddress:2283

Enjoy your self-hosted photo and video backup solution