ソースの回避策は、2025年のあるImmichパッケージでは実用的でしたが、現在のアップグレード手順にそのまま固定すべきではありません。コミュニティのユーザーは手動で変更しました immich-server および immich-machine-learning イメージタグを v1.134.0。元の投稿者によると、これは主要なZimaOSシステムでは最終的に機能しましたが、テストVMでは機能しませんでした。
その後、Immichはv3に移行し、保守対象のデプロイモデルでは、完全なDocker ComposeスタックとIMMICH_VERSION値を使用します。データベース、キャッシュ、機械学習、またはAPIの前提条件が変更された場合、サービスのタグを1つか2つだけ更新すると、バージョンが混在するスタックになる可能性があります。
2025年のソースでは、Immichの各サービスのタグを個別に編集していました
コミュニティはユーザーに、サーバーと機械学習の両方を変更するよう伝えました
CogZogは両方ともそうだと述べました immich-server および immich-machine-learning 新しいタグを使用する必要があります。ユーザーは両方を変更したと確認しましたが、テストVMは古いバージョンのままでした。
主要なZimaOSビルドは最終的にv1.134.0に到達しました
データベースイメージを手動で更新するルールは、ソースでは確立されていません
beepは、データベースもより新しく安定したタグに移行すべきか尋ねました。コミュニティの反応は本質的に「壊れていないなら直すな」というものでした。これは意見であり、Immichの移行ポリシーではありません。
現在のImmichはv3で、Composeの完全な更新手順があります
Immich v3.0.0は2026年7月にリリースされました。上流の案内では、次の設定を行って保守対象のスタックを更新します。 IMMICH_VERSION=v3 通常のComposeのpull／再作成手順を実行し、同時にv3の重大な変更と移行に関する注意事項も確認します。
現在のImmich v3リリースガイダンスを参照してください。
現在のアップストリームでは完全なDocker Composeバンドルを推奨
Immichの現在のインストールドキュメントでは、リリース版の docker-compose.yml および .env、その後で場所を設定し、 IMMICH_VERSION。PostgreSQLデータベースのパスは、ネットワーク共有ではなく、サポート対象のローカルファイルシステム上に置いてください。
手動またはカスタム環境への導入には、現在のImmich Composeモデルを使用してください。
ZimaOS App Storeパッケージでは、現在のアプリ更新手順を優先する
現在のZimaOS App Store 2.0には、インストール済みアプリの更新管理機能が含まれています。ストアパッケージでImmichの更新が提供されている場合は、1つのサービスのタグを個別に編集するのではなく、パッケージ定義によってマルチサービススタック全体を更新してください。
Immichをメジャーアップグレードする前にバックアップする
メジャーバージョンを変更する前に、写真・動画ライブラリとデータベース／アプリケーションの状態の両方を保護してください。ライブラリのディレクトリが正常なだけでは、アルバム、ユーザー、メタデータ、アプリケーションの状態を再構築するには不十分です。
バージョンが混在したImmichスタックの作成を避ける
Immichは独立した単一のコンテナではありません。アプリケーション、機械学習サービス、データベース、その他のサポートコンポーネントは、連携したリリース構成としてテストされています。別のイメージを固定したまま1つのイメージだけを更新すると、API、スキーマ、または起動時の互換性問題が発生する可能性があります。
そのソースは、ユーザーの実際のスタックがv1.134.0を実行できる程度に整合した場合にのみ動作したものであり、任意のタグを混在させても安全だという根拠にはなりません。
PostgreSQLをサポート対象のローカルストレージに置く
現在のImmichの要件では、PostgreSQLのデータディレクトリにローカルファイルシステムを使用し、ネットワーク共有上に配置しないよう求められています。データベースの状態は通常、写真ライブラリと比べて小さいものの、ユーザー、アルバム、メタデータ、アプリケーションの状態に不可欠です。
ZimaOSパッケージとカスタムComposeスタックのどちらをインストールしたかを把握する
ImmichがZimaOS App Storeから導入された場合は、ストアの現在の更新経路を使用し、パッケージの変更内容を確認してください。独自のComposeを取り込んだ場合は、アップストリームのバージョン固定、データベースパス、移行手順を自分で管理します。 .env、データベースパス、移行手順。
App Storeでの編集と、手動管理しているアップストリームのスタックを混在させると、今後のトラブルシューティングが難しくなります。
メジャーアップグレード前の事前確認を行う
- 写真ライブラリの最近のバックアップがあることを確認してください。
- データベースとアプリケーションの状態をバックアップしてください。
- 現在のバージョンとボリュームのマッピングを記録してください。
- アップストリームの破壊的変更に関する注意事項を読んでください。
- イメージのプルと移行に十分な空き容量がシステム/AppDataドライブにあることを確認してください。
更新後に実行中のバージョンとジョブを確認する
「保存が完了しました」で終わらせないでください。ImmichのAbout/Systemページを開き、実行中のサーバーバージョンを確認し、コンテナの状態をチェックしてから、アップロード、サムネイル、機械学習ジョブ、モバイルアプリの接続を検証してください。
元の内容自体がその理由を示しています。タグを編集しても、実行中のインスタンスが実際に更新されたことをすぐに意味するわけではありません。
ロールバックは、タグを元に戻すだけでは済まない場合があります
メジャーリリースでデータベーススキーマや状態が移行された後は、イメージをダウングレードできない場合があります。以前のタグに戻せば常に元に戻せると考えず、アップストリームの移行・ロールバック手順とバックアップを利用してください。
Immich更新に関するFAQ
2025年の手動タグ方式は、元のユーザーの主要システムで機能しましたか？
はい、最終的にはそうです。ただし、彼らのテスト用VMでは同じようには動作しませんでした。
現在のImmichユーザーは、immich-serverとmachine-learningのタグだけを更新すべきですか？
いいえ。現在のImmich v3は、バージョン情報と移行手順を含む完全なComposeスタックとして管理されています。
IceWhaleは、Immichの自動更新を約束していましたか？
いいえ。Zima-Giorgioが述べたのは、チームでその要望について話し合うということだけです。
