メインコンテンツにスキップ

システム設定

管理者ユーザーはここでImmichインスタンスの設定を管理できます。

ヒント

「デフォルトにリセット」ボタンをクリックすると、いつでもデフォルト設定に戻すことができます。

認証設定

パスワード、OAuth、およびその他の認証設定を管理する

OAuth認証

ImmichはOAuth認証をサポートしています。この機能および設定について詳しくはこちらをご覧ください。

パスワード認証

管理者は、インスタンス全体でユーザー名とパスワードによるログインを無効にすることを選択できます。これにより、システム管理者を含む誰もこの方法でログインできなくなります。OAuth認証も無効になっている場合、どの方法でもログインすることができなくなります。この設定を変更しても、既存のセッションには影響せず、新しいログイン試行にのみ影響します。

ヒント

サーバーCLIを使用して、いつでもパスワードログインを再有効化できます。

画像設定 (サムネイルとプレビュー)

  • サムネイル - メインタイムラインで使用されます。
  • プレビュー - アセットビューアで使用されます。

デフォルトではImmichは各アセットに対して3種類のサムネイルを作成します。 ぼかし (thumbhash)、小型 - サムネイル (webp)、及び大型 - プレビュー (jpeg/webp)。この設定では、作成されるサムネイルおよびプレビューファイルの品質を変更できます。

サムネイル形式 サムネイル画像の形式を選択できます。Webpはjpegよりもファイルサイズが小さくなりますが、エンコード速度が遅くなります。

ヒント

Webpをjpegに置き換える利点と欠点について詳しくはAdobeのウェブサイトをご覧ください。

サムネイル解像度 写真グループを表示する際 (メインタイムライン、アルバムビューなど) に使用されます。解像度が高いほど詳細を保持できますが、エンコードに時間がかかり、ファイルサイズが大きくなり、アプリの応答性が低下する可能性があります。

プレビュー形式 プレビュー画像の形式を選択できます。Webpはjpegよりもファイルサイズが小さくなりますが、エンコード速度が遅くなります。

プレビュー解像度 単一の写真の閲覧時や機械学習に使用されます。解像度が高いほど詳細を保持できますが、エンコードに時間がかかり、ファイルサイズが大きくなり、アプリの応答性が低下する可能性があります。

品質 画像品質を1〜100で設定します。値が高いほど品質が向上しますが、ファイルサイズが大きくなります。このオプションはプレビューとサムネイル画像に影響します。

広色域を優先 サムネイルにDisplay P3を使用します。これにより広い色空間を持つ画像の鮮やかさがより良く保持されますが、古いデバイスやブラウザでは異なる表示になる場合があります。sRGB画像は色味の変換を避けるためにsRGBとして保持されます。

埋め込みプレビューを優先 可能であれば、RAW写真の埋め込みプレビューを画像処理の入力として使用します。これにより、一部の画像でより正確な色が得られることがありますが、プレビュー品質はカメラに依存し、圧縮アーティファクトが多くなる可能性があります。

ヒント

大型サムネイルのデフォルト解像度を1440p(デフォルト)から1080pまたは720pに下げることで、記憶域を節約できます。

ジョブ設定

この設定を使用すると、マイクロサービス内の各タスクで同時に実行される作業量を決定できます。強力なハードウェアと優れたI/O性能を持つストレージを備えたコンピューターでは、いくつかのタスクをより高い値に設定できます。

同時実行数が増えると、ホストは複数のアセットを並行して処理します。 このアドバイスはスループットを改善しますが、レイテンシーは改善しません。例えば、スマート検索ジョブの処理を速めますが、検索自体を速くするわけではありません。

スマート検索、顔認識、顔検出、動画変換などのジョブは、多大な処理能力を必要とするため、ジョブ数を過剰に増やすとおそらくサーバーに著しく負荷がかかります。

重要

特にサムネイル生成用に同時並行数をデフォルト以上に設定する場合、使用可能なCPUコア数を超えないように注意してください。 これを超えると、サムネイル生成速度に利益を与えないまま、APIの応答性に影響する可能性があります。

顔認識の同時並行性

顔認識の同時並行性は変更できません。 DBSCANは伝統的に順次的なアルゴリズムですが、並列実装も存在します。我々の実装は並列処理に対応していません。

外部ライブラリ

ライブラリ監視 (実験的)

外部ライブラリは、完全再スキャンなしで変更されたファイルを自動的にインポートできます。これは、オペレーティングシステムがファイル変更を報告するとファイルをインポートします。写真がネットワークを介してマウントされている場合、この方法は動作しません。

定期スキャン

管理 -> 設定 -> ライブラリで外部ライブラリの再スキャンをトリガーするカスタム間隔を定義できます。 スキャン間隔は、プリセットまたはcron形式を使用して設定できます。詳細についてはCrontab Guruなどをご覧ください。

ロギング

デフォルトのImmichログレベルはLog(通常はInfoとして知られる)です。Immichの管理者は、個人の好みやImmichサポートチームの要請に応じて、ログレベルを高くまたは低く設定できます。

機械学習設定

この設定を通して、Immichにおける機械学習に関連するすべての設定を管理できます。リモート機械学習の設定からモデルとそのパラメータまでを含みます。 スマート検索や顔認識など、特定の種類の機械学習を無効にすることを選択できます。

URL

組み込みの(http://immich-machine-learning:3003)機械学習サーバーがデフォルトで設定されていますが、これを変更したり追加のサーバーを追加したりできます。

immich-machine-learningコンテナを強力なGPUを持つマシンにホストすることで、多数の写真(例: バッチインポート実行時)を効率的に処理したり、検索速度を向上させることができます。

複数のURLが指定されている場合、サーバーは最初から順次試行され、成功した最初のサーバーが使用されます。応答がないサーバーは、一時的に無視され、オンラインに戻るまで使用されません。

スマート検索

スマート検索設定を使用して、CLIPモデルを変更できます。より大きいモデルは通常より正確な検索結果を提供しますが、より多くの処理能力とRAMを消費します。CLIPモデルを変更する際、変更を完全に適用するにはすべての画像でスマート検索ジョブを再実行する必要があります。

インターネット接続

モデルを変更するには、インターネットに接続してモデルをダウンロードする必要があります。 ダウンロード後、設定でバージョン確認が有効になっている場合を除き、Immichをネットワークに接続する必要はありません。

重複検出

CLIP埋め込みを使用して、類似する重複画像を検出します。検出距離の最大値を設定して精度レベルを改善または減少させることができます。

  • 最大検出距離 - 重複として考慮するための2つの画像間の最大距離(範囲: 0.001〜0.1)。高い値はより多くの重複を検出しますが、偽陽性の発生可能性があります。

顔認識

この設定では顔認識の設定を変更できます。 編集可能な設定:

  • 顔認識モデル
  • 最小検出スコア
  • 最大認識距離
  • 最小認識顔数

これらのオプションの詳細は顔認識ページで確認できます。

情報

最小検出スコア、最大認識距離、最小認識顔数の値を変更した場合。 **ジョブ「顔認識 - 全て」**のみを再起動する必要があります。

顔認識モデルを交換した場合、**ジョブ「顔検出 - 全て」**を実行する必要があります。

同一双子

双子がいる場合、最大認識距離の値を少し下げると、区別しやすくなる場合があります。

地図&GPS設定

地図設定

これらの設定では、個人の好みに応じて、昼間モードと夜間モードの地図の外観を変更できます。 地図はOpenMapTilesなどを使用して調整することができます。

逆ジオコーディング設定

Immichは、GeoNames地理データベースのデータを使用した逆ジオコーディングをサポートしています。

通知設定

SMTPサーバーのセットアップ(ユーザー作成通知、新しいアルバム通知など)。詳細はこちらをご覧ください。

通知テンプレート

通知テンプレートを使用してデフォルトの通知文を上書きできます。詳細はこちらをご覧ください。

サーバー設定

外部ドメイン

共有リンクやメール通知でのドメイン名を上書きします。URLには末尾のスラッシュを含めないでください。

ウェルカムメッセージ

管理者はログイン画面にカスタムメッセージを設定できます(メッセージはすべてのユーザーに表示されます)。

ストレージテンプレート

Immichはカスタムストレージテンプレートをサポートしています。この機能とその設定についての詳細はこちらをご覧ください。

テーマ設定

カスタムCSSを作成し、すべてのユーザーのウェブアプリケーションに読み込むことができます。これにより、管理者はフォント、色、その他のスタイルを変更できます。

例:

カスタムCSS
p {
color: green;
}

ゴミ箱設定

削除されたファイルを保存するゴミ箱をシステム管理者が設定できます。これらのファイルはデフォルトで削除日から30日間、またはシステム管理者が定義した期間保存されます。

ゴミ箱は無効化できますが、これは推奨されません。将来削除されるファイルが完全に削除されるためです。

永久削除用のキーボードショートカット

アセットを選択し、タイムラインからCtrl + Delを押してゴミ箱オプションなしで素早く永久削除できます。

ユーザー設定

削除遅延

システム管理者は、管理パネルを通じてユーザーを削除することができます。システム管理者は、ユーザーを即座に削除するか、または削除を遅延(デフォルトでは7日後)させるかを選択できます。この操作により、ユーザーのアカウントと資産が永久に削除されます。ユーザー削除ジョブは深夜に実行され、削除の準備が整ったユーザーをチェックします。この設定への変更は、次回の実行時に評価されます。

バージョンチェック

このオプションが有効になっている場合、immich-serverはGitHubに定期的にリクエストを行い、新しいリリースがあるかを確認します。

ビデオトランスコーディング設定

システム管理者は、どのビデオファイルを異なる形式に変換するかを設定できます。この設定は詳細に変更することができ、ここで使用される用語について詳しく知りたい場合は、H.264コーデック、HEVCコーデック、VP9コーデックのFFmpegドキュメントを参照してください。

ビデオファイルのどのストリームがトランスコードされるかは、トランスコードポリシーによって決定されます。トランスコードされるストリームは以下の設定(設定ファイル名)を使用します。トランスコードされないストリームは変更されず、元の設定が保持されます。

許可されるコンテナ形式 (ffmpeg.acceptedContainers)

ビデオアセットのコンテナ形式がこのリストに含まれていない場合、ストリームがトランスコードを必要としなくてもMP4にリマックスされます。

デフォルトの許可されるコンテナ形式はmovoggwebmです。

プリセット (ffmpeg.preset)

トランスコードにどれだけの「計算負荷」をかけるか。これらはH.264のプリセット名を使用しており、異なるエンコーダでの設定に応じて適切な値に変換されます。

デフォルト値はultrafastです。

オーディオコーデック (ffmpeg.targetAudioCodec)

オーディオストリームをトランスコードするときに使用するオーディオコーデック。mp3aaclibopusのいずれかを指定できます。

デフォルト値はaacです。

ビデオコーデック (ffmpeg.targetVideoCodec)

ビデオストリームをトランスコードするときに使用するビデオコーデック。h264hevcvp9av1のいずれかを指定できます。

デフォルト値はh264です。

ターゲット解像度 (ffmpeg.targetResolution)

ビデオストリームをトランスコードする際、アスペクト比を維持しながら最大の寸法をこの値に縮小します。ビデオは決して拡大されません。

デフォルト値は720です。

トランスコードポリシー (ffmpeg.transcode)

トランスコードポリシーは、ビデオアセットのどのストリームがトランスコードされるかを設定します。トランスコードの判断はビデオストリームとオーディオストリームごとに独立して行われます。これはつまり、ビデオストリームがトランスコードを必要としてもオーディオストリームが必要ない場合、ビデオストリームのみがトランスコードされ、オーディオストリームはそのままコピーされるということです。トランスコードポリシーがどのストリームもトランスコードを必要とせず、かつビデオのリマックスも必要ない場合、別個のビデオファイルは作成されません。

デフォルトのポリシーはrequiredです。

すべてのビデオ (all)

ビデオは常にトランスコードされます。これにより、ビデオ再生時の一貫性が保証されます。

ビデオをまったくトランスコードしない (disabled)

ビデオは決してトランスコードされません。これにより、サーバーのスペースとリソースを節約できますが、ソース形式をサポートしないデバイス(特にウェブブラウザ)上での再生が妨げられたり、高ビットレートのファイルを再生する際に高帯域幅を使用する可能性があります。

許可される形式にないビデオのみ (required)

以下のいずれかの条件が満たされる場合、ビデオストリームがトランスコードされます:

  • ビデオがHDRである。
  • ビデオがyuv420pピクセル形式でない。
  • ビデオコーデックがacceptedVideoCodecsに含まれていない。

オーディオストリームはオーディオコーデックがacceptedAudioCodecsに含まれていない場合にトランスコードされます。

許可される形式にないか最大ビットレートを超えるビデオ (bitrate)

requiredの条件に加えて、ビデオストリームがmaxBitrateを超えるビットレートである場合にもトランスコードされます。

許可される形式にないかターゲット解像度を超えるビデオ (optimal)

requiredの条件に加えて、水平および垂直寸法がターゲット解像度を超える場合にはビデオストリームがトランスコードされます。