ファイルのカスタムロケーション

このガイドでは、生成されたファイルや元のファイルをDockerのボリュームマウントを使用して異なる場所に保存する方法について説明します。

バックアップ

ガイドに従って新しいバックアップパスを設定した後、自動バックアップツールを使用している場合は、特にprofile/を含めて、バックアップ設定を更新することを忘れないでください。

.envファイルで使用したいパスを定義します。すべてを定義する必要はないことに注意してください：UPLOAD_LOCATIONはデフォルトでファイルが保存される基準フォルダとなり、他のパスはオーバーライドとして機能します。

.env
# サポートされているすべての環境変数のドキュメントは[こちら](/docs/install/environment-variables)で確認できます

# アップロードされたファイル、サムネイル、トランスコードされたビデオファイルが保存されるカスタムロケーション
- UPLOAD_LOCATION=./library
+ UPLOAD_LOCATION=/custom/path/immich/immich_files
+ THUMB_LOCATION=/custom/path/immich/thumbs
+ ENCODED_VIDEO_LOCATION=/custom/path/immich/encoded-video
+ PROFILE_LOCATION=/custom/path/immich/profile
+ BACKUP_LOCATION=/custom/path/immich/backups
...

これらのファイルの場所を定義した後、docker-compose.ymlファイルを編集し、immich-serverコンテナに新しい変数を追加します。これらのパスはコンテナ内でマウントされる場所なので、変更しないでください。

docker-compose.yml
services:
  immich-server:
      volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
+     - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
+     - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+     - ${PROFILE_LOCATION}:/usr/src/app/upload/profile
+     - ${BACKUP_LOCATION}:/usr/src/app/upload/backups
      - /etc/localtime:/etc/localtime:ro

この変更を行った後、Immichが必要なすべてのファイルを見つけられるように新しいフォルダにファイルを移動する必要があります。重要なものをまだアップロードしていない場合は、データベースフォルダを削除してImmichを完全にリセットすることもできます。その後、Immichを再起動して変更を登録します：

docker compose up -d

ノート

Dockerバインドマウントの特性上、upload/フォルダとlibrary/フォルダを同じデバイス上で別々のバインドマウントとしてマウントすることは推奨されません。このため、HDDやネットワークストレージ（NAS）を/usr/src/app/uploadにマウントし、その下にアクセスしたいフォルダをマウントします。

thumbs/フォルダには、タイムラインに表示される小さいサムネイルと、画像をクリックしたときに表示される大きなプレビューの両方が含まれており、これらを分離することはできません。

ImmichサーバーのストレージメトリクスはUPLOAD_LOCATIONで利用可能なストレージを追跡するため、管理者はストレージが不足しないように監視を設定する必要があります。profile/フォルダは非常に小さく、通常1MB未満です。