コミュニティソリューション

ZimaOSでImmichの写真ストレージをNASまたは大容量ディスクに移動する

A March–April 2025 Immich storage thread where an IceWhale reply pointed users to Docker path mapping and a community member documented the exact host-side volume changes needed to move database, model cache, uploads, and selected media paths to larger storage.

Immichは大量のストレージを消費する可能性があるため、増え続ける写真ライブラリのアップロードデータ、データベース、機械学習キャッシュをZimaOSのシステムディスクに置いたままにするのは、ほとんどの場合理想的ではありません。

この2025年のスレッドでは、ホスト側のボリュームマッピングを編集して、Immichを別のZimaOSストレージ場所へ移動する手動の方法を説明しています。現在のZimaOSには、より直接的な保存場所の変更機能と移行機能も用意されているため、手動操作のスクリーンショットは、コンテナパスがどのように対応しているかを理解するための説明として扱うのが適切です。

ボリュームを変更する前にImmichの設定を開く

ストレージボリュームを変更する前の、設定オプションが強調表示されたZimaOS Immichアプリのメニュー
コミュニティで紹介された手順では、Filesでフォルダーをやみくもに移動するのではなく、インストール済みのImmichアプリの設定を開くことから始めていました。

コンテナパスではなく、データベースのホストパスを移動する

/media/Main上のホストパスを指定し、PostgreSQLのコンテナパスは変更していないImmichのデータベースボリュームマッピング
コミュニティで動作した設定では、データベースマッピングのZimaOS側を変更し、PostgreSQLのコンテナ内の保存先はそのままにしていました。

このホストとコンテナの区別は非常に重要です。アプリケーションはコンテナ内の特定のパスを必要とするため、スタックの仕組みを理解せずに両方を変更すると、起動できなくなったり、既存のデータが見つからないように見えたりする可能性があります。

機械学習キャッシュも大容量ストレージに移動できる

ZimaOS上の大容量な/mediaパス以下にモデルキャッシュを保存するImmichの機械学習ボリュームマッピング
コミュニティの例では、ホスト側のモデルキャッシュフォルダーを移動し、コンテナが必要とするキャッシュ保存先は維持していました。

immich-serverタブでは、より注意が必要

アップロードパスと選択したメディアフォルダーが/media以下のストレージにリダイレクトされたImmichサーバーのボリュームマッピング
原著者は、immich-serverの一部のマッピングは変更すべき一方で、その他はアプリケーションが想定する内容から変更してはいけないと強調しています。

元の投稿はコミュニティで検証されたものであり、すべてのImmichバージョンに対するIceWhaleの保証ではありません。Immichのスタックは時間の経過とともに大きく変化しているため、現在のパッケージでこの2025年のボリュームテーブルをそのまま再現せず、必ず現在のアプリ定義と比較してください。

現在のZimaOSには、より直接的なストレージ移行手順がある

現在のZimaOS向けImmich手順では、ストレージファイルの保存場所を変更でき、Data Migrationまたは管理された手動コピーによってImmichのデータを別のディスクへ移動する方法も説明されています。

現在のインストール環境では、2025年のスクリーンショットを参考にボリュームマッピングを再構築する前に、現在のImmichの保存場所変更および移行機能から始めてください。

手動でファイルを移動する場合は、まずImmichを停止する

現在のZimaOSのガイダンスでは、ImmichのGalleryデータを手動でコピーする前にImmichを無効化し、その後、該当するホスト側パスを更新してアプリケーションを再起動するよう案内しています。移動中の書き込みを停止することで、写真ライブラリの不整合なコピーが作成されるリスクを減らせます。

ZimaOS上のImmichストレージに関するよくある質問

Immichの写真をZimaOS-HDではなく大容量ディスクに保存できますか?

はい。2025年のコミュニティ例でも、現在のZimaOS向けImmichの手順でも、別のストレージ場所を使用できます。

コンテナ側のPostgreSQLパスを変更すべきですか?

元の手順では変更していません。ホスト側のストレージパスを変更し、アプリケーションコンテナ側のパスはPostgreSQLが想定する場所のままにしています。

2025年の4つのタブすべてに、正確に従う必要がありますか?

いいえ。これらはコンテナの構成例を示す過去の資料として扱ってください。何かを変更する前に、現在のImmichパッケージと比較してください。

現在は組み込みの移行オプションがありますか?

現在のZimaOS向けImmichのガイダンスでは、ImmichデータについてData Migrationと、管理された手動移動の両方が説明されています。