MirrorNest
← All guides

Immich

A self-hosted photo and video backup solution that mirrors the Google Photos experience, with mobile apps that auto-upload your camera roll to your own server.

Target: Any Docker hostMediaPhotosOfficial homepage ↗Official docs ↗
This guide is synthesized from Immich's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Create a project directory

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

  2. 2Download the official compose and env files

    Immich publishes a ready-to-use docker-compose.yml and example .env with each release.

    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. 3Configure the .env file

    Edit UPLOAD_LOCATION to a path with enough disk space, set a non-default DB_PASSWORD (alphanumeric only), and set your TZ.

    Requires Docker Engine v25+ from Docker's own repository, not your distro's package — and use `docker compose` (v2), not the old `docker-compose`.

  4. 4Start Immich

    docker compose up -d

  5. 5Create the admin account

    Visit the web UI and complete the registration form — the first account created automatically becomes the administrator.

    open http://<server-ip>:2283