ghcr.io/imagegenius/immich:3.2.2

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 #可选
    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，需验证 https://docs.openvino.ai/2024/about-openvino/system-requirements.html；还需添加 --device-cgroup-rule='c 189:* rmw' -v /dev/bus/usb:/dev/bus/usb。

NVIDIA（CUDA）

1. 安装 https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html。
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：

镜像构建方式

此仓库使用 GitHub Actions 构建，基于 https://github.com/home-operations/containers 的工作流模板。

• 容器基于 https://github.com/linuxserver/docker-baseimage-ubuntu 构建。
• Immich 的上游媒体依赖脚本在此 Dockerfile 中运行，然后应用和变体阶段在此基础上构建。
• 变体通过 docker-bake.hcl 选择。
• s6-overlay 相关文件位于 root/ 目录下。
• Renovate 从 bake 注释中跟踪 Immich 和构建输入的版本更新。