Immichのタグ更新とZimaOSのバージョン境界を解説

ZimaOS上のImmichユーザーがアプリケーションイメージにlatestを選択したものの、インストール済みのサーバーが古いリリースのままになっていました。議論からは、Immichの更新には少なくとも2つのコンテナ（サーバーと機械学習）が関係する可能性があり、ImmichとZimaOSの両方の進化に伴って正しい手順も変わったことが分かります。

これは時代を問わず適用できるアップグレード手順ではなく、バージョンに依存するコミュニティの経緯です。初期の返信はZimaOS 1.3.1-1上のImmich 1.123～1.125に関するもので、後の公式案内では、ZimaOS 1.5.1が古いImmichバージョンからバージョン2へのアップグレードと、そのデータベース移行に対応すると説明されています。

初期のケースでlatestを選択するだけでは不十分だった理由

元のユーザーはlatestを選択していましたが、より新しいサーバーイメージを取得できませんでした。別の参加者もImmich 1.123のまま更新できないと報告しています。コミュニティからは、1つのサービスだけを変更するのではなく、immich-serverとimmich-machine-learningの両方のイメージ設定を確認するよう助言がありました。

ZimaOSのアプリ設定に表示されたImmichサーバーと機械学習のイメージタグ — 返信では、2つのImmichサービスに個別のイメージ設定があることが強調されました。

参加者はまた、表示上のlatestが、常に期待したイメージになるわけではないと注意を促しました。明示的なリリースタグも試されましたが、スクリーンショットからは、タグを入力してもZimaOS 1.3.1-1のすべてのケースが解決したわけではないことが分かります。

正確なタグ構文は重要だったが、それだけが問題ではなかった

あるトラブルシューティングでは、手動入力したバージョンが公開済みのイメージタグと完全には一致していないことに気付きました。回答者は、議論で参照されたコンテナタグ一覧を確認し、保存して再起動する前に、両方のサービスで同じ明示的なバージョンを使用するよう提案しました。

ZimaOS上でImmichアプリのバージョンが1.123のままになっている状態 — ユーザーは、インストール済みのImmichバージョンが1.123のままであることを示しました。

ZimaOSの設定に入力された明示的なImmichイメージバージョン — latestでアプリが更新されなかったため、明示的なバージョンが試されました。

更新のトラブルシューティング中に表示されたImmich機械学習コンテナのタグ — 機械学習イメージは、サーバーイメージと併せて確認する必要がありました。

更新のトラブルシューティング中に表示されたImmichサーバーコンテナのタグ — 同じ試行で表示された、対応するサーバータグです。

その試行の作成者は、返信で提案されたどちらのタグのバリエーションでもアップグレードを完了できなかったと報告しました。この結果は重要です。このスレッドは、特定の1.125タグを古いアプリパッケージに対する普遍的な解決策として提示する根拠にはなりません。

後のユーザーは両方のコンテナをImmich 2.2.3に更新した

2025年11月、Immich 2.1.0を実行している参加者が、latestでは依然として更新できないと報告しました。そのユーザーは、機械学習コンテナとサーバーコンテナの両方でバージョン2.2.3を手動選択することで更新に成功し、別の参加者も同じ組み合わせの変更が自分の環境で機能したと確認しました。

ZimaチームメンバーのGiorgioは、別のバージョン境界について説明しました。ZimaOS 1.5.1では、Immichアプリを古いバージョンからバージョン2へアップグレードでき、更新ボタンを選択すると、ZimaOSがバックグラウンドでデータベースの問題を処理するとのことです。この公式説明は、後の1.5.1での手順に適用されるものであり、スレッド冒頭にある1.3.1-1のスクリーンショットには適用されません。

大幅なバージョンジャンプには独自の移行手順が必要になる場合がある

2026年5月の返信では、非常に古いImmichのインストール環境では、最新リリースへ直接ジャンプするのではなく、小刻みに更新する必要がある場合があると述べられています。スレッドには、すべての中間バージョンを網羅した検証済みの手順は示されていないため、このコメントは検証済みの移行マトリックスではなく、コミュニティからの助言として扱うべきです。

このスレッド全体から得られる教訓は、何かを変更する前に、ZimaOSのリリース、現在のImmichバージョン、イメージの取得元、そして対応する2つのサービスのタグを確認することです。2.xのマイナーアップデートで報告された解決策を、はるかに古い1.xのデータベース移行にそのまま適用すべきではありません。