https://github.com/imagegenius/docker-immich

Immich 是一个高性能的自托管照片和视频备份解决方案。

变体

使用语义化版本标签固定特定的上游Immich版本，可选择添加变体后缀：

ghcr.io/imagegenius/immich:2.7.5
ghcr.io/imagegenius/immich:2.7.5-cuda

要求

• PostgreSQL：版本 14-17 并带有 https://github.com/tensorchord/VectorChord — 使用 https://github.com/immich-app/base-images/pkgs/container/postgres 可跳过扩展设置。
• Valkey/Redis：外部提供或通过 docker mod（见下文）。通过 DB_URL 配置 SSL PostgreSQL。

Redis 的 Docker Mod

• 设置 DOCKER_MODS=imagegenius/mods:universal-redis
• 设置 REDIS_HOSTNAME=localhost

用法

Docker Compose

---
services:
  immich:
    image: ghcr.io/imagegenius/immich:latest
    container_name: immich
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DB_HOSTNAME=192.168.1.x
      - DB_USERNAME=postgres
      - DB_PASSWORD=postgres
      - DB_DATABASE_NAME=immich
      - REDIS_HOSTNAME=192.168.1.x
      - DB_PORT=5432 #可选
      - REDIS_PORT=6379 #可选
      - REDIS_PASSWORD= #可选
      - SERVER_HOST=0.0.0.0 #可选
      - SERVER_PORT=8080 #可选
      - MACHINE_LEARNING_HOST=0.0.0.0 #可选
      - MACHINE_LEARNING_PORT=3003 #可选
      - MACHINE_LEARNING_WORKERS=1 #可选
      - MACHINE_LEARNING_WORKER_TIMEOUT=120 #可选
    volumes:
      - path_to_appdata:/config
      - path_to_photos:/photos
      - path_to_libraries:/libraries #optional
    ports:
      - 8080:8080
    restart: unless-stopped

  valkey:
    image: valkey/valkey:8-bookworm
    container_name: valkey
    ports:
      - 6379:6379

  postgres14:
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
    container_name: postgres14
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: immich
      # 非SSD存储时取消注释：
      # DB_STORAGE_TYPE: 'HDD'
    volumes:
      - path_to_postgres:/var/lib/postgresql/data
    ports:
      - 5432:5432

参数

硬件加速

Intel（QSV / OpenVINO）

• 将 /dev/dri 挂载到容器中（--device=/dev/dri:/dev/dri）。
• 对于 OpenVINO，请验证 CPU 支持；还需添加 --device-cgroup-rule='c 189:* rmw' -v /dev/bus/usb:/dev/bus/usb。

NVIDIA（CUDA）

1. 安装 NVIDIA 容器工具包。
2. 使用 --runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all 或 --gpus=all 运行。

现有库

• 将库文件夹挂载到 /libraries（多用户场景挂载到 /libraries/ ）。
• 在 Immich 管理设置中，将 /libraries（或每个用户的路径）注册为外部路径。
• 在账户设置中，添加指向 /libraries 或 /libraries/ 的库。

用户/组 ID 及 umask

设置 PUID=1000 PGID=1000 以匹配主机上的卷所有权（使用 id user 命令查看您的 UID/GID）。可选设置 UMASK=022（按减法生效，而非加法）。

更新

docker pull ghcr.io/imagegenius/immich:latest
docker stop immich && docker rm immich
# 使用相同的 docker run 参数重新创建容器
docker image prune # 可选：删除悬空镜像

或者使用 compose：docker compose pull && docker compose up -d。

支持

• 问题：
• Immich：

镜像构建方式

CI/CD 在 GitHub Actions 上运行，遵循 https://github.com/home-operations/containers 使用的容器工作流。变体是在构建时通过 docker-bake.hcl 选择的 Dockerfile 阶段；s6-overlay 监控树位于 root/ 目录下。上游 Immich 版本通过 bake 文件上的注释由 Renovate 进行跟踪。