要件

Immichのハードウェアおよびソフトウェア要件：

ハードウェア

• OS: 推奨はLinuxまたは*nix系のオペレーティングシステム（Ubuntu、Debianなど）。
  • 非Linux系OSではDockerの使用体験が劣るため、強く非推奨です。 非Linux系OSでのセットアップやトラブルシューティングの支援能力は大幅に落ちます。 それでも非Linux系OSを使用したい場合、以下の方法で設定を行ってください：
    • Windows: Docker Desktop on Windows または WSL 2。
    • macOS: Docker Desktop on Mac。
  • Immichは、フルバーチャルマシンで実行する仮想化環境で問題なく動作します。 LXCコンテナでのDocker使用は推奨されません。ただし、上級ユーザーであれば可能かもしれません。 問題が発生した場合、サポートされているVMデプロイメントに切り替えることをお勧めします。
• RAM: 最低4GB、推奨6GB。
• CPU: 最低2コア、推奨4コア。
• ストレージ: ユーザー/グループの所有権とパーミッションをサポートするUnix互換のファイルシステム（EXT4、ZFS、APFSなど）を推奨。
  • サムネイルとトランスコードされたビデオの生成により、写真ライブラリのサイズが平均で10〜20％増加する可能性があります。

ヒント

良好なパフォーマンスとPostgresデータベースへの安定した接続は、Immichの快適な体験にとって重要です。 Postgresデータベースファイルのサイズは通常1〜3 GBです。 そのため、Postgresデータベース（DB_DATA_LOCATION）は理想的にはローカルSSDストレージを使用し、ネットワーク共有を使用しないでください。 さらに、Dockerリソース制限を使用する場合、Postgresデータベースには少なくとも2GBのRAMが必要です。 Windowsユーザーは非Unix互換のファイルシステムに関連する問題に直面する可能性があります。詳細は下記をご覧ください。

ソフトウェア

ImmichはDockerとDocker Composeプラグインを必要とします：

• Docker Engine: このCLIバリアントはLinuxサーバー用（またはWindowsではWSL2経由）に設計されています。
• Docker Desktop: このGUIバリアントはLinuxでは推奨されませんが、WindowsまたはmacOS用に利用可能です。

Composeプラグインは、リンクされたインストールガイドに従うことでDocker Engine及びDesktopによってインストールされます。また、別途インストールすることもできます。

ノート

Immichはdocker composeコマンドを必要とします。類似の名前を持つdocker-composeは非推奨であり、もはやImmichではサポートされていません。

Windowsユーザー向け特別要件

Windowsシステム上のデータベースストレージ

Immich Postgresデータベース（DB_DATA_LOCATION）は、ユーザー/グループの所有権とパーミッションをサポートするファイルシステム（EXT2/3/4、ZFS、APFS、BTRFS、XFSなど）上に配置する必要があります。NTFSまたはex/FAT/32でフォーマットされたファイルシステム上では動作しません。 WSL（Windows Subsystem for Linux）を使用している場合、ホストディレクトリがマウントされている場合（通常、/mnt以下）は動作しません。 この問題がある場合、バインドマウントを次のようにDockerボリュームに変更できます：

.envに以下の変更を加えてください：

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

docker-compose.ymlの最後に以下の行を追加してください：

volumes:
  model-cache:
+ pgdata: