はじめに

Immichとは、一言で言うとセルフホスト版のGoogleフォトです。公式にはLinux系OSのみをネイティブにサポートしており、今までWindowsで動かすには、WSLやDocker Desktopを用いるか、野良の非公式のフォークをつかうしかありませんでした。
そこで、私自身が普段からImmichをWindowsで動かしているため、WSLのオーバーヘッドや無駄なメモリ消費を減らすため、自分でリポジトリを作成しました。

リポジトリはこちらになります。

GitHubGitHub - AkaakuHub/immich-windowsContribute to AkaakuHub/immich-windows development by creating an account on GitHub.

なぜフォークしないのか

Immich本家のメンテナが、ディスカッションにてこう述べています。

There is not, and won’t be.

Immich公式では、Linux専用の依存関係があるため、WindowsではDockerやWSLを使って動かす方法が案内されています。

しかし、実際にImmichの構成を確認すると、PostgreSQL、FFmpeg、画像処理に使われるlibvips/Sharp、機械学習関連など、主要な依存関係の多くはWindowsでも利用できます。Windows対応で特に問題になるのはVectorChordやValkeyなど一部の依存関係で、これらもWindows向けにビルド・構成することで対応できると考えました。

そこで、DockerやWSLを使わず、ImmichをWindows上でネイティブに動作させるために、このリポジトリを作成しました。

主な対応内容

ここでは今回パッチした内容を簡潔にまとめます。
単にImmichをWindowsで起動できるようにするだけではなく、普段の運用までWindows上で完結できるようにしています。

主な対応内容は次の通りです。

  • Immich ServerのWindows対応

    • Linux固有のパスや/dev/nullなどの処理をWindowsに対応
    • Windowsの絶対パス、フォルダーパス、glob、外部ライブラリのパスを正しく扱えるよう修正
    • PostgreSQLやgzipなど、外部コマンドの呼び出しをWindowsに対応
  • 主要な依存関係をWindows向けに用意

    • PostgreSQL 18向けのpgvectorとVectorChordをWindows用にビルド
    • Immich本家に合わせたJellyfin FFmpegを使用
    • Sharp / libvipsもWindows向けにビルドし、HEVC、JPEG XL、RAWなど本家で利用される画像・動画形式に対応
  • 機械学習機能もネイティブWindows化

    • Immich Machine LearningをWindows上のPython / Uvicornで直接実行
    • CLIPによるスマート検索、顔認識、OCRなど利用可能
    • DirectMLにも対応しており、対応するAMD・Intel・NVIDIA GPUでONNX推論を実行可能
  • インストールから日常的な操作まで自動化

    • Install.cmdから必要な依存関係を取得してセットアップ
    • Windowsサービスとして全ユーザー向けに常駐するAllUsersと、ログイン中だけ動作するCurrentUserの2方式に対応
    • タスクトレイの通知領域にImmichのアイコンを表示し、起動・停止・ブラウザ表示・更新などをGUIから操作可能
    • WSL版Immichからデータベースやメディアを移行するためのツールも用意

更新についても、単にファイルを上書きするのではなく、更新前のデータベースバックアップ、依存関係の再利用、起動後の動作確認、失敗時の旧バージョンへの復旧までを堅牢に行う仕組みを実装しています。

また、Immichのコード全体をコピーせずに必要な修正だけをパッチとして管理することで、クリーンなリポジトリを目指しました。

今後について

基本的には本家に追従してパッチは自動適用するようにしていますが、コンフリクトなどが発生したときに飽きていたら放置するかもしれないので責任は負えません。