Immich

Use these steps to download the official Immich Docker Compose files and start the service.

Create the Immich Directory

Create a dedicated folder for Immich and move into it:

mkdir ./immich-app
cd ./immich-app

Download the Compose File

Download the latest official docker-compose.yml file from Immich:

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml

Download the Environment File

Download the example environment file as .env:

wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

Configure the Environment File

Open .env and review these values before starting Immich.

You can find documentation for all supported environment variables here:

https://docs.immich.app/install/environment-variables

# The location where your uploaded files are stored.
UPLOAD_LOCATION=./library

# The location where your database files are stored.
# Network shares are not supported for the database.
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment this and use a valid TZ identifier.
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like v2.1.0.
IMMICH_VERSION=v2

# Connection secret for Postgres. Change this to a random password.
# Use only A-Za-z0-9 characters, without special characters or spaces.
DB_PASSWORD=changeThisPassword

# The values below this line usually do not need to be changed.
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

Start Immich

Run Docker Compose from the immich-app directory:

docker compose up -d

Reverse Proxy / HTTPS

If you need public HTTPS access, put Immich behind a reverse proxy like Nginx Proxy Manager.