環境
- TrueNAS SCALE 25系
- community train の Immich
- Jellyfin / Tailscale も稼働中
発生した症状
TrueNAS SCALE の「アプリ」画面で、Immich に「アップデート可能」が表示されていました。
しかし、
- 更新ボタンを押してた後、更新が完了しない
- Web UI ボタンを押しても反応なし。
- Rollbackできない
- docker ps に immich が表示されない
という状態になりました。
Apps画面では「動作中」と表示されているのに、Dockerコンテナが存在しないという不整合状態でした。
最初に確認したこと
TrueNAS の Shell を開いて、以下を実行しました。
sudo docker ps -auser@truenas[~]$ sudo docker ps -a
IMAGE STATUS NAMES
ghcr.io/tailscale/tailscale:v1.96.5 Up 3 hours (healthy) ix-tailscale-tailscale-1
jellyfin/jellyfin:10.11.8 Up 3 hours (healthy) ix-jellyfin-jellyfin-1
```結果、Immich が存在していませんでした。
Rollbackを試した結果
Apps画面から Rollback を実行しようとしましたが、以下のエラー。
App must not be in stopped state to rollbackつまり TrueNAS 側では、
- Immich は停止状態
- しかしコンテナは存在しない
という壊れ方をしていたようです。
解決した方法
Apps画面で Immich を一度「停止」させ「開始（Start）」ボタンを押しました。
早い話が再起動です。
再度 Shell で確認。
sudo docker ps -a
IMAGE STATUS
ghcr.io/immich-app/immich-server:v2.4.1 healthy
ghcr.io/immich-app/postgres:15-vectorchord0.5.3 healthy
ghcr.io/immich-app/immich-machine-learning:v2.4.1 healthy
ghcr.io/tailscale/tailscale:v1.96.5 healthy
jellyfin/jellyfin:10.11.8 healthy結果、以下のコンテナが生成されました。
- immich-server
- postgres
- machine-learning
- redis
すべて healthy 状態。
Web UI確認
その後、Web UI も正常に開けるようになりました。
さらに Docker image を確認。
sudo docker images | grep immich
REPOSITORY TAG CREATED SIZE
ghcr.io/immich-app/postgres 15-vectorchord0.5.3 4 months ago 503MB
ghcr.io/immich-app/immich-server v2.4.1 4 months ago 1.77GB
ghcr.io/immich-app/immich-machine-learning v2.4.1 4 months ago 1.3GB
ghcr.io/immich-app/postgres <none> 4 months ago 503MB
ghcr.io/immich-app/immich-server v2.2.3 6 months ago 1.76GB
ghcr.io/immich-app/immich-machine-learning v2.2.3 6 months ago 1.3GB
ghcr.io/immich-app/postgres 15-vectorchord0.4.3-pgvectors0.2.0 7 months ago 762MB最新版イメージ（v2.4.1）に更新されていました。
ただし「アップデート可能」表示だけ残る
実体は更新済みでしたが、TrueNAS GUI 上では「アップデート可能」が残ったままでした。
これは TrueNAS SCALE 25系で時々発生する GUIキャッシュ不整合 の可能性があります。
現時点では、
- Immich正常動作
- WebUI正常
- DB正常
- Docker healthy
なので、後日 TrueNAS を再起動して様子を見る予定です。
学んだこと
TrueNAS GUI表示だけでは信用しすぎない
Apps画面が壊れていても、Docker実体は正常な場合があります。
まずは Shell で確認
sudo docker ps -aはかなり重要。
削除より先に「開始」を試す
今回は Start ボタンだけで復旧しました。
もし先に削除していたら、再構築作業になっていた可能性があります。
まとめ
TrueNAS SCALE の Immich 更新トラブルでは、
- Rollback
- 削除
- 再インストール
を急ぐ前に、
まず：
sudo docker ps -aで実体確認をおすすめします。
今回のように「開始」だけで復旧するケースもありました。
コメント