ZimaOSに表示されるImmichのバージョンが上流のImmichリリースより古く、App StoreにUpdateボタンがない場合は、コンテナを手動で更新する方法があります。ただし、正しい方法は、インストールしたZimaOSのImmichパッケージによって異なります。2025年12月のIceWhale Communityスレッドでは、BigBear Immichパッケージでイメージタグを簡単に変更する方法が確認されましたが、その後の返信では、同じ方法では他のすべてのImmichパッケージを確実に更新できないことが示されました。
コミュニティの方法は、アプリの設定を開き、次の項目だけを変更することでした： immich-server および immich-machine-learning イメージタグを対象リリースに変更し、データベースとRedisのタブはそのままにします。投稿者は更新が問題なく完了したことを確認し、別のBigBearユーザーは後にv2.3.1からv2.4.1への更新に成功しました。ただし、現在のImmichのドキュメントでは、管理者がリリースノートを読み、データベースをバックアップし、Composeやデータベースの変更を考慮してからアップグレードすることが求められています。したがって、タグを手動で変更する方法を、普遍的に「常に安全」な更新ボタンとして扱うべきではありません。
まず、インストールしたImmichパッケージを特定する
このスレッドには、少なくとも2つのデプロイ経路が含まれています：
- BigBear Immich：複数のユーザーが、ZimaOSでイメージタグを編集することで更新を正常に開始できたと報告しました。
- 元のBigBearではないパッケージ：後のユーザーは、サーバーと機械学習のバージョンを手動で変更しても、v2.1.0のままだったと報告しました。
ZimaOSでImmichアプリの設定を開き、変更前に現在のイメージ名、タグ、ボリュームのマッピング、データベースイメージ、環境変数を記録します。BigBearの定義向けに書かれた手順が、別のApp Storeテンプレートにも適用できるとは限りません。
コミュニティでうまくいったBigBearタグ更新
コミュニティで成功した手順は次のとおりです：
- ZimaOSのダッシュボードで、Immichアプリの三点メニューを開きます。
- Settingsを選択します。
- immich-machine-learningタブを開きます。
- そのイメージのTagを目的のImmichリリースに変更します。
- immich-serverタブを開きます。
- そこでも同じリリースタグを設定します。
- リリースノートでデータベースやコンテナの変更が明示的に必要とされていない限り、データベースとRedisのタブは変更しないでください。
- 設定を保存し、ZimaOSに影響を受けるコンテナを再作成・再取得させます。
元の返信当時、例として示されていたタグは次のとおりでした：
v2.3.1そのバージョンは過去のものです。その後、別のユーザーが次のバージョンに更新しました： v2.4.1、そして2026年4月の返信では v2.7.4。現在、古いバージョン番号をそのまま使わないでください。現在のImmichのリリースノートとアップグレード経路を確認してから、対象バージョンを選択してください。
投稿者が確認したこと
BigBearタグの手順を受け取った後、MikeFrizzは、そのヒントが非常に役立ち、更新も問題なく完了したと返信しました。これは、元のスレッドで確認できる最も確かな結果です。
その確認は、元の投稿者が使用したパッケージとバージョンの状況における方法を裏付けるものです。手動で2つのタグを編集するだけで、今後のすべてのImmichメジャーバージョンや、すべてのZimaOSパッケージに十分だと証明するものではありません。
「latest」タグで問題が解決すると決めつけない
あるユーザーがタグを次のように変更しました latestしかし、ZimaOSは以前インストールされていたバージョンに繰り返し戻りました。その後、スレッドには、次のような試行を提案する推測が含まれています。 リリースただし、これらの一般的なタグ名に基づく、情報源で確認された普遍的な解決策はありません。
現在のImmichドキュメントでは、明示的なバージョン変数を使用し、独自のDocker Composeワークフローでメジャーバージョンのメタタグに対応しています。パッケージ化されたZimaOSアプリでは、パッケージ定義と上流イメージが実際にサポートするタグ形式を使用してください。ラベルがもっともらしく見えるからといって、タグを勝手に作らないでください。
バージョンを変更する前にImmichをバックアップする
現在のImmichドキュメントでは、マイグレーションを伴う可能性のあるアップグレードの前に、データベースをバックアップすることを明確に推奨しています。写真や動画にも独立したバックアップ戦略が必要です。データベースのバックアップだけでは、メディアライブラリ自体の代わりにはなりません。
手動でバージョンを変更する前に、現在のImmichバックアップおよび復元ガイドを使用してください。
最低限、以下を保持してください。
- Immichデータベースのバックアップ
- メディアライブラリ／アップロードデータ
- 現在のZimaOSアプリ設定とボリュームマッピング
- 現在のイメージタグ
- および環境変数やカスタムストレージの場所。
バージョンを変更する前にImmichのリリースノートを読む
現在のImmichアップグレードドキュメントでは、更新前に管理者が破壊的変更についてリリースノートを確認するよう求めています。通常の上流Docker Composeの手順は次のとおりです。
docker compose pull && docker compose up -dただし、対象リリースに適したCompose定義とバージョン変数になっている場合に限ります。
現在のImmichアップグレードガイドを参照してください。
これはZimaOSで重要です。パッケージ化されたアプリでは、イメージタグだけでなく、Compose相当の定義も遅れる可能性があるためです。新しい immich-server イメージによっては、古いパッケージには含まれていないデータベース、環境設定、ヘルスチェック、またはボリュームの変更が必要になる場合があります。
Immichサーバーと機械学習のバージョンの互換性を維持する
コミュニティでは、具体的に両方のタグを変更しました immich-server および immich-machine-learning現在のImmichドキュメントでも、メインサーバーと機械学習コンポーネントのバージョン不一致は、バグや不安定性の原因になる可能性があると警告しています。
利用可能なイメージが先に表示されたからといって、2つのうち一方だけを更新しないでください。現行のリリースドキュメントで明示的に別扱いとされていない限り、両者を連携した1つのアプリケーションバージョンとして扱ってください。
データベースコンテナのタグを無作為に変更しないでください
データベースタブをそのままにしておくというコミュニティの助言は、そこで議論されていたBigBearの特定のマイナーアップデートについては妥当でした。ImmichのPostgreSQL層には独自のマイグレーションがあり、古いベクター拡張機能からVectorChordへの移行など、時間の経過とともに変更も行われています。
- すべてのタグの数値を似たものにするためだけに、データベースイメージを更新しないでください。
- データベースイメージは決して変更してはいけないと決めつけないでください。現在のImmichのリリースノートでデータベース／Composeの移行が必要とされている場合は、その文書化された移行手順に従ってください。
元のZimaOS Immichアプリが古いバージョンのままの場合
2026年3月の返信では、そのユーザーはBigBear App Store版を実行しておらず、機械学習とサーバーのイメージを手動で更新しようとしても、Immich v2.1.0のままで行き詰まっていると述べられていました。そのスレッドには、そのユーザーの元のパッケージ構成について確認済みの解決策は記載されていません。
これは重要な境界線です。イメージタグを手動で変更してもアプリが更新されない場合は、同じ操作を繰り返すのをやめてください。パッケージの現在のコンテナ定義をImmichの現在のCompose要件と比較し、データパスをバックアップして確認したうえで、保守されているZimaOSパッケージへの移行を検討してください。
データベースとメディアのボリュームがどこに保存されているか把握する前に、動作しているImmichパッケージをアンインストールしないでください。
コミュニティユーザーがBigBearのImmichパッケージを提案した理由
最初の返信では、通常アップストリームのリリースに近い状態で維持されていることを理由に、BigBearのImmichアプリが推奨されました。その後に成功したタグ編集手順も、BigBearで明示的にテストされたものでした。
これは、既存のライブラリに対する「BigBearを再インストールする」操作が安全なワンクリック移行手段になるという意味ではありません。新しいパッケージでは、異なるボリューム名、データディレクトリ、データベースイメージ、または環境変数が使用される可能性があります。パッケージの移行は、既存スタックのアップグレードとは別の操作として扱ってください。
自動コンテナ更新ツールには注意してください
2026年4月のコミュニティ返信では、コンテナの確認と自動更新を行うWatchtowerより簡単な代替手段として、Tugtainerが提案されました。この提案はステートレスなサービスには便利かもしれませんが、ImmichはPostgreSQLデータベースと文書化された破壊的変更を伴うアップグレード手順を持つ、状態を保持するマルチコンテナアプリケーションです。
Immichでは、リリースノートを確認せずにイメージを自動置換するのは危険です。現在のImmichドキュメントでは、アップグレード前に破壊的変更を考慮するよう管理者に明示的に求めています。自動コンテナ更新ツールを使う場合でも、Immichについては新しいタグが出るたびに盲目的に更新するのではなく、通知または手動承認を優先してください。
より安全なZimaOS Immich更新ワークフロー
- インストール済みパッケージがBigBearのものか、別のImmich定義かを記録します。
- 現在のサーバー、機械学習、データベース、Redisのイメージ／タグを記録します。
- Immichのデータベースと重要なメディアをバックアップします。
- 現在のバージョンとターゲットバージョンの間にある、重大な変更を伴う境界ごとに、上流のリリースノートを確認してください。
- ターゲットバージョンでCompose、データベース、環境変数、またはストレージの変更が必要かどうかを確認してください。
- 互換性のあるBigBearのマイナーアップデートでは、コミュニティで行われたように、serverとmachine-learningのタグを同時に変更してください。
- ドキュメント化されたアップグレード手順で変更が明示的に必要とされていない限り、データベースとRedisのイメージは変更しないでください。
- アプリの設定を保存し、新しいイメージの起動中にコンテナログを監視してください。
- 古いイメージを削除する前に、ImmichのWeb UIのバージョン、アップロード、サムネイル、機械学習、既存ライブラリを確認してください。
- パッケージがすぐにロールバックするか古いバージョンのままの場合は、タグを繰り返し強制するのではなく、パッケージ定義を確認してください。
Immich更新後の確認事項
- Web UIが読み込まれ、意図したサーバーバージョンを表示します。
- モバイルアプリが接続でき、サーバーのメジャーバージョンと互換性があります。
- 既存の写真と動画が正しく開きます。
- 新しいアップロードが正常に完了します。
- サムネイル生成とトランスコードのジョブが実行されます。
- 機械学習機能がバージョン不一致エラーなしで起動します。
- PostgreSQLコンテナは正常な状態を維持しています。
現在のImmichドキュメントでは、ダウングレードはサポートされた復旧方法ではないと記載されています。データベース移行後にタグを元に戻せば簡単に復旧できると考えるより、バックアップを取るほうが安全です。
ZimaOS Immich更新FAQ
ZimaOSのイメージタグを変更してImmichを更新できますか？
一部のパッケージとバージョンの組み合わせでは、はい。元の投稿者と別のBigBearユーザーは、serverとmachine-learningの両方のタグを変更することで機能したと確認しています。一方、スレッドには、この方法で古いインストールの問題が解決しなかったBigBear以外のユーザーの報告もあります。
変更すべきImmichのタグはどれですか？
確認済みのBigBearコミュニティの方法では、 immich-server および immich-machine-learning タグが同時に変更されました。古いv2.3.1、v2.4.1、v2.7.4の例を現在のターゲットバージョンとしてそのまま使用しないでください。
latestを使用すべきですか？
汎用的な解決策ではありません。スレッド内のあるユーザーは、 latest 定着しませんでした。実際のパッケージと現在のImmichのガイダンスでサポートされているバージョニング方式を使用してください。
docker pullだけを実行すればよいですか？
新しいイメージを取得するだけでは、実行中のコンテナは再作成されず、Composeの変更も適用されません。Immichの上流版では docker compose pull && docker compose up -d ターゲットリリース用の設定を準備した後。
TugtainerまたはWatchtowerでImmichを自動更新すべきですか？
自動更新では、Immichが明確に推奨しているリリースノートの確認や移行の検証が省略される可能性があります。データベースを使用する状態保持型アプリケーションでは、通知を行ったうえで管理された手動アップグレードのほうが、無条件の自動置換より安全です。
Immichを更新する前にバックアップは必要ですか？
はい。Immichの現在のアップグレードおよびバックアップのドキュメントでは、アップグレード前にデータベースを保護することが推奨されています。また、代替のないメディアは別途保護してください。
