ZimaOS上のImmichで、immich-serverのイメージタグだけを編集した後も古いバージョンのままの場合は、コンテナを1つずつ変更するのをやめ、まずパッケージ／スタックを特定してください。 Immichは複数のサービスで構成されるアプリケーションです。サーバー、機械学習、データベース、キャッシュの各コンポーネントは互換性を維持する必要があり、ZimaOSの一部のパッケージは異なるApp Storeの配布元によって管理されています。
ソーススレッドは、1つのフィールドだけを更新すると失敗する理由を示しています。ユーザーはサーバーイメージを変更し、ネットワークのダウンロードアクティビティを確認して再起動しましたが、Immichには依然としてv2.6.1と表示されました。別のユーザーは、サービスイメージが一致する動作中のv3.1.0構成を示しました。したがって、正しい手順は「バックアップし、スタックを特定し、一貫性を保って更新し、検証する」であり、「1つのフィールドに新しい番号を入力する」ことではありません。
ステップ1：インストールしたImmichパッケージを特定する
ZimaOSには、公式ストアとサードパーティー／コミュニティストアのパッケージが存在する場合があります。アプリ設定を開き、次の項目だけでなく、すべてのサービスイメージを記録してください。 immich-server.
更新メタデータを誰が管理しているか把握できるよう、App Storeの配布元も確認してください。
ステップ2：大規模な更新を行う前にImmichをバックアップする
写真ライブラリとPostgreSQLデータベースをバックアップします。現在のImmichのバックアップと復元ガイドでは、データベースダンプの手順が説明されています。
コンテナの再作成をバックアップと見なさないでください。
ステップ3：すべてのサービスのバージョンを確認する
ソースの比較結果には次の項目が記載されていました：
- Immichサーバー；
- Immichの機械学習；
- Postgres；
- Valkey/Redis。
完全なイメージタグを記録します。App Storeがテスト済みのバンドルとして管理している場合は、1つのコンポーネントだけを先行して手動更新するのではなく、App Storeの更新操作を優先してください。
ステップ4：利用可能な場合はApp Storeの更新を使用する
現在のZimaOSドキュメントでは、最新のImmichパッケージをApp Storeからインストールできると記載されています。更新ボタンが表示されている場合は、それを使用してパッケージメンテナーのCompose定義も同時に更新してください。
現在のZimaOS Immichガイドが、現在の公式ZimaOSの開始点です。
1つのタグを編集するとダウンロードされたように見えるのに更新されない理由
アプリマネージャーは新しいイメージを取得しても、ストアのメタデータ、別の保存済みYAML値、または別のイメージ定義からサービスを再作成する場合があります。そのため、実行中のコンテナが古いタグに戻ることがあります。
次のコマンドで、実際に実行中のイメージを確認してください。
docker ps --format '{.Names} {.Image}'Immichのメジャーバージョンを確認せずに飛び越えないでください
Immichのリリースには、データベース／スキーマやサービスの変更が含まれる場合があります。移行するバージョンについて、上流のリリース／アップグレードノートを読んでください。互換性のある組み合わせを推測するのではなく、スタック全体を一体として更新してください。
BigBearまたはその他のサードパーティパッケージを使用している場合
ZimaSpaceの別のコミュニティガイドでは、イメージタグの変更が一部のBigBearパッケージで機能した一方、後のユーザーは同じ方法がすべてのパッケージに共通して有効ではないことを確認したと説明しています。この回避策を適用する前に、パッケージの提供元を特定してください。
Immichの更新ガイドでは、そのパッケージ固有の境界について説明しています。
スタックを再作成した後に更新を確認する
3か所を確認してください。
- 実行中のDockerイメージタグ；
- Immich自体のサーバーバージョン表示；
- マイグレーションまたは互換性エラーについては、コンテナのログを確認してください。
更新を強制するためにデータベースやアップロードフォルダーを削除しないでください
ボリュームの削除は破壊的なリセットであり、更新方法ではありません。検証済みのバックアップがあり、新規インストールを意図的に行う場合を除き、データベースと写真ライブラリを保持してください。
よくある質問
サーバータグを変更したのに、Immichに2.6.1と表示され続けるのはなぜですか？
アプリが古いサービス定義を再作成しているか、スタックが一貫して更新されていない可能性があります。実際に実行中のイメージとパッケージの提供元を確認してください。
機械学習のバージョンはサーバーのバージョンと完全に一致させるべきですか？
デプロイするImmichのリリース／Compose定義に記載された、テスト済みのバージョンに従ってください。各サービスに独立したタグを勝手に設定しないでください。
immich-serverだけを更新できますか？
それをデフォルトにするのは避けてください。Immichは複数のサービスで構成されるスタックであり、アップグレードには連携した変更が必要になる場合があります。
まず何をバックアップすべきですか？
PostgreSQLデータベースと、メディア／アップロードストレージ。メジャーバージョンを変更する前に、バックアップを検証してください。
