アップデートの基本手順
1. リリースノートの確認(必須) Immichの公式GitHub(Releasesページ)で最新バージョンの変更点を確認します。「Breaking changes」という項目がある場合は、そこに書かれている指示に従って、先に docker-compose.yml や .env を書き換えてください。
2. ディレクトリの移動 ターミナルで、Immichの docker-compose.yml ファイルが保存されているディレクトリに移動します。
Bash
cd /あなたの/immich/ディレクトリのパス
3. 最新イメージのダウンロード(プル) 以下のコマンドを実行して、新しいバージョンのDockerイメージを取得します。
Bash
docker compose pull
4. コンテナのアップデートと再起動 新しいイメージを適用してバックグラウンドで起動します。
Bash
docker compose up -d
補足: ダウンタイムを最小限にするため、事前に
docker compose downでコンテナを止める必要はありません。直接pullしてからup -dを実行すれば、コンテナが自動的に新しいものに切り替わります。
5. 古いイメージの削除(オプション) ストレージの容量を圧迫しないよう、アップデート後に不要になった古いイメージを削除しておくことをおすすめします。
Bash
docker image prune
途中で Are you sure you want to continue? [y/N] と聞かれたら、y を入力してエンターを押します。
アップデート後の注意点
再起動後、データベースの更新や写真のインデックス再構築がバックグラウンドで行われることがあります。写真の枚数が多い場合、数分〜数十分ほど動作が重くなったり、一部の機能が準備中になったりすることがありますが、エラーが出ない限りはそのまま完了をお待ちください。
もし別の環境(UnraidやSynologyのGUIなど)で構築されている場合や、エラーが出てしまった場合は、具体的な状況を教えていただければサポートいたします。





