ハクソク

世界を動かす技術を、日本語で。

Immich 3.0

2026年7月2日原文(github.com)

概要

Immich v3.0.0がリリースされ、多数の新機能と改善が追加 APIエンドポイントなどに破壊的変更あり、通常利用者には影響小 モバイル編集や自動化Workflowsなど注目機能が登場 アップデート手順やマーチャンダイズ情報も案内 開発者向けの主なBreaking Changesも詳細に記載

Immich v3.0.0 リリースノート

  • Immich v3.0.0 の正式リリース

    • 数ヶ月にわたるチームとコントリビューターの努力による成果
    • 破壊的変更を含むメジャーアップデート

  • 破壊的変更 （Breaking Changes）の案内

    • 主にAPIエンドポイントの更新
    • サードパーティツール利用者のみ影響
    • 通常ユーザーは従来通りのアップデート手順

  • アップデート方法

    • .envファイルの IMMICH_VERSION をv3に変更
      • 例: IMMICH_VERSION=v3
    • docker compose pull && docker compose up -dで更新

  • リリース候補（Release Candidates）の導入

    • v3.0.0からプレリリース版のテスト提供開始
    • 通知設定は Admin settings > Version check options で変更可能

  • 新マーチャンダイズの案内

    • 子供服やフルカラー刺繍ロゴ入り商品を新発売
    • オンラインストア: https://immich.store

新機能・改善点ハイライト

  • モバイル非破壊編集

    • v2.5.0のWeb編集機能をモバイルにも展開
    • 元ファイルを保持しつつトリミング・回転・調整が可能
    • 編集履歴の再調整や復元も可能
    • 一部旧機能（リカラー、Live Photo編集等）は一時削除

  • Workflows（プレビュー）

    • トリガー・フィルター・アクションを組み合わせて自動化フローを作成
    • Webの Utilities > Workflows から利用
    • ビジュアル/JSONエディタ切り替え可
    • 作成フローはテキストまたはJSONで共有可能

  • バックグラウンドバックアップ改善

    • Android: 新しいタスクスケジューラーで全ライブラリの自動バックアップ対応
    • バッテリー最適化や通知設定の干渉も警告
    • iOS: 並列処理で短時間内にアップロード開始

  • 最近追加ページ

    • 新たに追加されたアセット順で閲覧可能な「Recently Added」ページ
    • Webは「Explore」タブ、モバイルは「Search」タブに配置

  • 整合性チェック機能

    • メンテナンスページに「Integrity reports」追加
    • ファイルシステムとDBの差異を検出し、未追跡・欠損・チェックサム不一致を報告
    • 実行時間の設定も可能

  • モバイルスライドショー

    • 写真・動画を自動再生するスライドショー機能
    • Web同様の体験をモバイルで提供

  • HLS & リアルタイム動画トランスコーディング（プレビュー）

    • オンザフライで動画変換、クオリティ切り替えやストレージ削減
    • ハードウェアアクセラレーション推奨
    • Webアプリで先行実装、モバイル対応も進行中
    • 旧アセットは Metadata Extraction の再実行が必要

  • 新Web用ビデオプレイヤー

    • 統一デザイン・操作性、再生速度変更など基本機能搭載
    • iOSでの表示問題も改善

  • Androidギャラリー機能

    • 他アプリからImmichを画像ビューアとして直接起動可能
    • ファイルの共有やライブラリへのアップロードも対応

  • モバイルOCR機能

    • 画像内のテキスト認識・ハイライト・コピーが可能

  • アルバムへの直接アップロード（モバイル）

    • ローカル写真をアルバムに直接アップロード可能
    • バックアップと整理のフローを簡素化

  • 画像共有時のサイズ選択（モバイル）

    • 共有前に画像サイズを選択可能
    • デフォルト動作はApp Settings > Preferencesで設定
    • シェアボタン長押しでその場選択も可

  • タイムライン表示のパフォーマンス改善

    • 一ヶ月に大量アセットがある場合でもスムーズな表示

Immichプロジェクト支援案内

  • プロダクトキー購入や公式グッズ購入による支援
    • https://buy.immich.app
    • https://immich.store

主なBreaking Changes一覧（開発者向け抜粋）

  • class-validatorからzodへの移行
  • replace assetの削除
  • 古いタイムライン同期エンドポイントの削除
  • APIキーのスキーマ名称変更
  • pvgecto.rsサポートの廃止
  • OAuth関連のバリデーション強化とセキュリティ向上
  • エラーレスポンスの簡素化
  • album ownerからalbum_userへの移行
  • /api/server/themeエンドポイントの削除
  • 詳細は マイグレーションガイド を参照

さらなる詳細やフィードバックは、公式GitHubディスカッションスレッドやドキュメントを参照

Hackerたちの意見

いろいろなことに時間をかけて設定したのに、一度使ったらその後は全然使わないものがたくさんあるよね。簡単に設定できて、毎日ちょっとずつ役立つものもいっぱいあるけど。Immichは、設定にめちゃくちゃ時間をかけたのに、年に一回しか使わない。でも、その一回使うときは本当にやってよかったと思う。素晴らしいソフトウェアだね。

└

俺もそんなにいい経験ができたらよかったな。プロックスモックスのLXCを使ったんだけど、2ヶ月間整理した後にデータが壊れちゃって、デバッグする気力がなかった。確か大きなバージョン移行に関係してたと思う。これでそのスタックに対して気が引けちゃった。アップグレードが思ったほど簡単じゃなかったし、今も状況は変わってないと思う。ダサいライブラリシステムの外でフォルダを整理できるようになりたいんだけど、当時Immichもそれに対抗してたんだよね。

Immichって、読み取り専用のソースフォルダに対応してる？元のファイルをそのままにしておきたいんだけど、Immichにインデックスさせたいんだ。

└

うん、少なくとも1年間は大丈夫だよ。「外部ライブラリ」機能があったと思うけど、それが君の望んでることをやってくれるんじゃないかな。

└

うん、外部ライブラリを使ってるよ。もう何年も前からの機能だね。docker composeを読み取り専用でマウントすれば、読み取り専用にできるよ。

Immichは素晴らしいソフトウェアだよ。Googleフォトの代わりに定期的に使ってる。普通はGoogleフォトにアップロードしない大きな動画をここに保存してるし、家でのサクサクした使い心地はクラウドベースのソリューションよりもいいよ。

14個のGoogleテイクアウトのチャンクをImmichにインポートするベストな方法について、誰かアドバイスある？一度すべてのチャンクをダウンロードしたけど、50GBのサイズのせいで壊れちゃったんだ。ブラウザを使ったのが原因かも。wgetや他の代替手段も、Googleテイクアウトの認証やセッションクッキーが必要だから使えないみたい。まだ各巨大バンドルをImmichにインポートすることすら試してないけど、約700GBをデータベースにうまくインポートする方法についてのアドバイスがあればすごく助かる。ここ1年くらいDockerでImmichを使ってるけど、まだ最新バージョンにはアップグレードしてない。Googleフォトのバックアップは、もう1年くらい前からスマホで無効にしてるけど、過去のデータを全部取り込むのはまだやってない。あと、Immichを時々起動しなくても写真をアップロードできるか知ってる人いる？「マイクラウド」に自動で送信してくれたら最高なんだけど。素晴らしいソフトウェアだよ。

└

このツールを使えば、Immichにデータを取り込めるよ。すべてのメタデータを解析して、GPhotosにあるアルバムを再作成してくれる。https://github.com/simulot/immich-go

└

immich-goは必要なものが揃ってるよ。

└

ちょっと注意なんだけど、ネイティブのWindows解凍は32bitで、4GBを超えるアーカイブでは動かなくなるよ。もしそれを使ってるなら、7zipとかで解凍した方がいいよ。

└

もし画像をファイルシステム（NASや似たようなサーバー共有）に全部入れられれば、Immichの外部ライブラリ機能を使えるよ（https://docs.immich.app/features/libraries/）。これを使うと、メディアファイルを非同期インポートジョブで処理できるから、ウェブAPI経由で直接アップロードするよりも信頼性が高いよ。俺のセットアップでは、外部ライブラリ機能だけを使ってて、NASから読み取り専用の共有をImmichサーバーにマウントしてる。外部ライブラリは数時間ごとにデータベースに再同期されるから、Immichがファイルを壊す心配もなく、自分でメディア資産を管理できるんだ。もし最終的にImmichから移行することになっても、日付で整理されたメディアファイルのフォルダが一つあるだけだから楽だよ。唯一の欠点は、メディアファイルを直接Immichにアップロードしてないことだけど、それは問題ないよ。Syncopoliを使って、携帯から中間サーバーにファイルを同期して、そこからNASの共有に永久的に保存する前にEXIFデータを整理してるんだ。携帯からImmichに写真を移すのに手動のステップは一切ないよ！

└

おそらくベストなアプローチではないけど、私は約200GiBあった。ウェブUIで一度に1万ファイル以下を選んでアップロードした（2014年分を選んでから2015年分を選んだ）。それで大丈夫だったよ。それ以上になるとUIが使えなくなった。外部ライブラリは良い選択肢かも。最近Androidアプリでバックグラウンドインポートが改善されたって聞いたから、それも試してみる価値があるかも。

Hacker Newsで議論の続きを見る