ONLINE RUNBOOK

Immich update procedure

A Docker Compose maintenance procedure.

Use your deployment’s Compose directory and service names in the commands below.

  1. Confirm readiness

    Review release notes, confirm a recent backup, verify storage availability, and identify the correct Compose project.

  2. Connect through the private administrative path

    Use the management network or VPN. Confirm the target host and Compose directory before changing anything.

    cd <immich-compose-directory>
    pwd
    docker compose ps
  3. Pull the approved images

    Download the images referenced by the existing Compose configuration.

    docker compose pull
  4. Redeploy the stack

    Recreate changed containers in detached mode, preserving configured persistent storage.

    docker compose up -d
  5. Validate service health

    Check service state and inspect recent logs for startup, database, permission or storage errors.

    docker compose ps
    docker compose logs --tail=100 <service-name>
  6. Test the application

    Sign in through the normal user-facing URL. Confirm library visibility, upload behavior and background processing.

Validation checklist

CheckExpected result
ContainersExpected services are running or healthy
Web interfaceAuthentication and navigation work
StorageLibraries and uploads are accessible
LogsNo persistent database, cache or application errors

Safety notes