系統需求

Immich 的硬體與軟體需求如下：

硬體需求

• 作業系統（OS）：推薦使用 Linux 或類 Unix 作業系統（Ubuntu、Debian 等）。
  • 非 Linux 作業系統的 Docker 運行體驗較差，強烈不建議使用。 我們對非 Linux 作業系統的設置或故障排除協助能力將大幅降低。 如果您仍希望在非 Linux 作業系統上運行，可以按以下方式設置：
    • Windows：Docker Desktop on Windows 或 WSL 2。
    • macOS：Docker Desktop on Mac。
  • Immich 在完整虛擬機中的虛擬化環境中運行良好。 不建議在 LXC 容器中使用 Docker（詳見），但技術熟練的用戶可能成功運行。 如果有問題，建議切換到受支持的虛擬機部署。
• 記憶體（RAM）：至少 4GB，建議 6GB。
• 處理器（CPU）：至少 2 核心，建議 4 核心。
• 儲存空間：推薦使用支持使用者/群組所有權與權限的 Unix 相容檔案系統（EXT4、ZFS、APFS 等）。
  • 縮略圖和轉碼影片的生成平均會使照片庫大小增加 10-20%。

提示

Postgres 資料庫的良好效能和穩定連線對流暢的 Immich 體驗至關重要。 通常情況下，Postgres 資料庫檔案大小在 1-3GB 之間。 因此，Postgres 資料庫（DB_DATA_LOCATION）最好使用本地 SSD 儲存，並且避免任何形式的網路共享。 此外，若使用了 Docker 資源限制，Postgres 資料庫至少需要 2GB 記憶體。 Windows 用戶可能會遇到非 Unix 相容檔案系統的問題，詳情見下文。

軟體需求

Immich 需要 Docker 與 Docker Compose 插件：

• Docker Engine：適用於 Linux 伺服器（或 Windows 經由 WSL2）設計的 CLI 版本。
• Docker Desktop：適用於 Windows 或 macOS 的 GUI 版本，但 不推薦 用於 Linux。

無論是 Docker Engine 或 Desktop 安裝指南，皆會安裝 Compose 插件；也可以單獨安裝。

注释

Immich 需要使用 docker compose 指令；名稱類似的 docker-compose 已被淘汰，Immich 不再支持。

Windows 用戶的特殊需求

Windows 系統上的資料庫儲存

Immich 的 Postgres 資料庫（DB_DATA_LOCATION）必須位於支持使用者/群組 所有權與權限的檔案系統（EXT2/3/4、ZFS、APFS、BTRFS、XFS 等）。 它無法在任何格式為 NTFS 或 ex/FAT/32 的檔案系統上運行。 在使用掛載的主機目錄（通常在 /mnt 底下）的 WSL（Windows Linux 子系統）中也無法運行。 若遇到此問題，您可以將綁定掛載改為 Docker 卷，具體配置如下：

修改 .env 如下：

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

在 docker-compose.yml 底部添加以下內容：

volumes:
  model-cache:
+ pgdata: