Immich Installation Guide (Updated for 2026)

This guide reflects the current Immich repository structure, correct internal ports, and the updated installation workflow. It replaces all outdated tutorials that reference the old immich-docker repository.

1. Install Dependencies

sudo apt update
sudo apt install -y docker.io docker-compose-plugin git

2. Clone the Correct Immich Repository

The old immich-docker repo no longer exists. Use the main repo:

git clone https://github.com/immich-app/immich.git
cd immich/docker

3. Create the Environment File

Immich now ships with example.env. Copy it to .env:

cp example.env .env

Edit the file if needed:

nano .env

4. Adjust the Port Mapping (Optional)

Immich uses internal port 2283 for the API server. To expose it on a custom port (example: 9100 on MSI):

nano docker-compose.yml

Find the immich-server service and update:

ports:
  - "9100:2283"

For a second machine (example: Johannes), you may use:

ports:
  - "2283:2283"

5. Start Immich

docker compose up -d

Check container status:

docker ps

6. Access Immich

Open your browser and navigate to:

http://YOUR-IP:YOUR-PORT

Examples:

• MSI: http://192.168.x.x:9100
• Johannes: http://192.168.x.x:2283

7. Verify the Server is Running

From the host machine:

curl http://localhost:9100

You should see HTML output from Immich.

8. Updating Immich

cd immich
git pull
cd docker
docker compose down
docker compose up -d

9. Notes for Dual‑Home or HAProxy Users

• Each machine must expose Immich on a unique port.
• Internal port 2283 must not be changed.
• HAProxy can normalize both machines to port 443 externally.

Last updated: January 2026