システムの整合性

フォルダチェック

情報

これらのチェックに考慮されるフォルダには次が含まれます: upload/, library/, thumbs/, encoded-video/, profile/, backups/

Immichが起動すると、ストレージシステムで使用されるボリュームマウントに対してファイルの読み書きが可能であることを検証するための一連のチェックを実行します。必要な操作をすべて実行できない場合、起動が失敗します。チェック内容は以下の通りです:

このチェックは以下のような状況を検出するために設計されています:

ノート

.immichファイルはマーカーとして機能し、Immichが使用しているボリュームマウントを追跡するのに役立ちます。以下の状況を除いて、手動で作成または削除するべきではありません。

システムマウントフォルダチェックの検証 (enabled=true)
...
ENOENT: no such file or directory, open 'upload/encoded-video/.immich'

上記のエラーメッセージは、サーバーが以前に(正常に)各フォルダに.immichファイルを書き込んだが、現在はそれらを検出できないことを示しています。これは以下のいずれかの理由による可能性があります:

権限エラー - ファイルを読み取ることができないが、存在はしている
ファイルが存在しない - ボリュームマウントが変更されているため修正が必要
ファイルが存在しない - ユーザーが手動で削除している場合、手動で再作成する必要がある (touch .immich)
ファイルが存在しない - ユーザーがバックアップから復元したが、各フォルダを復元しなかった場合 (すべてのフォルダを復元するか、欠落しているフォルダに手動で.immichを作成する必要がある)

警告

このチェックは、過去にユーザーが経験した一般的な問題を検出するために設計されており、通常は解決すべき問題があることを示しています。あなたが何をしているかを理解していて、それらを無効にしたい場合は、以下の環境変数を設定できます:

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true