Immich

最終更新日: 2026年4月23日

目次

テンプレート説明

Immichは、写真・動画のセルフホスト型バックアップ・管理プラットフォームです。スマートフォンからの自動バックアップ、AIを活用した顔認識・物体検出・シーン分類、地図ベースの位置情報ブラウジングなど、Google フォトに近い体験をプライベート環境で実現します。

本テンプレートはインストール完了後もサービスは停止状態を維持します。管理スクリプトによる初期セットアップ後に手動でサービスを起動してください。

スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。

メモ

Immich は開発が活発なプロジェクトであり、公式も本番環境での利用に際しては定期的なバックアップを推奨しています。大切なデータは別途バックアップを取ることを強くお勧めします。

仕様

対応OSイメージ

Ubuntu 24.04 LTS

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
Immich Latest AGPL-3.0 写真・動画管理サーバー / 機械学習サービス
Docker Engine Latest Apache 2.0 コンテナランタイム
Docker Compose Latest Apache 2.0 コンテナオーケストレーション
PostgreSQL 14（immich-app/postgres カスタムイメージ） PostgreSQL License メインデータベース（pgvecto.rs / VectorChord 拡張含む）
Valkey 9 BSD-3-Clause キャッシュ・キュー管理
Nginx Latest BSD-2-Clause リバースプロキシ
Certbot Latest Apache 2.0 Let’s Encrypt SSL証明書の取得・更新

スタートアップスクリプト情報

項目 説明
アプリケーション利用ポート 80/tcp (HTTP)、443/tcp (HTTPS)
インストールディレクトリ /opt/immich
アップロードデータ保存先 /opt/immich/library
データベース保存先 /opt/immich/postgres
SSL証明書保存先 /etc/immich/ssl/
管理スクリプト /root/immich-manage.sh、/root/immich-diagnose.sh、/root/immich-letsencrypt.sh、/root/immich-change-domain.sh
初期状態 サービス停止中（セキュリティのため）

その他

最小システム要件

  • CPU: 2コア以上（4コア推奨）
  • メモリ: 最小4GB、推奨6GB以上
  • ディスク容量: バックアップする写真・動画の容量に応じた十分な空き容量
  • ネットワーク: パブリックIPアドレス

メモ

機械学習機能（顔認識・物体検出）を有効に活用するには、6GB以上のメモリを推奨します。4GBでも動作しますが、機械学習処理のパフォーマンスが制限される場合があります。

利用手順

メモ

スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。
インストール完了後、rootディレクトリに「immich-info.txt」というファイルが作成されますのでご確認ください。
ファイルが存在しない場合、作成されるまでしばらくお待ちください。
スタートアップスクリプトの実行状況は、SSH接続後に以下のコマンドで確認できます。

# tail -f /var/log/immich-setup.log

重要

セキュリティ上の理由により、テンプレート作成直後はImmichサービスが停止状態です。以下の手順に従って安全にサービスを起動し、設定を行ってください。

Step 1: VPSへの接続

SSHクライアントを使用してrootユーザーでVPSに接続します。

# ssh root@<IPアドレス>

Step 2: 初期セットアップの実行

管理スクリプトの setup コマンドを実行し、Dockerイメージをダウンロードします。

# /root/immich-manage.sh setup

メモ

Immich・機械学習・データベース等のDockerイメージのダウンロードに数分かかる場合があります。完了するまでそのままお待ちください。ネットワークエラーでダウンロードが中断された場合は、同じコマンドを再実行してください。

Step 3: サービスの起動

start コマンドでImmichとNginxを起動します。

# /root/immich-manage.sh start

起動完了後、以下のURLでアクセスできます（初期状態では自己署名証明書のためブラウザに警告が表示されます）。

https://<IPアドレスまたはドメイン>

Step 4: 管理者アカウントの作成

ブラウザでImmichにアクセスすると、初回ログイン時に管理者アカウントの作成画面が表示されます。画面の指示に従って管理者アカウントを作成してください。

セキュリティ重要

管理者アカウントは必ずサービス起動後すみやかに作成してください。管理者アカウントが未設定の状態では、誰でも最初にアクセスした人が管理者になれてしまいます。

Step 5: HTTPS設定（推奨）

独自ドメインを取得済みの場合は、Let’s Encryptの無料SSL証明書を取得することでブラウザ警告を解消できます。
事前にDNSの設定を完了し、ドメインがVPSのIPアドレスに向いていることを確認してください。

# /root/immich-letsencrypt.sh -e [email protected] -d your-domain.com

Step 6: ドメイン変更（オプション）

ドメインを変更する場合は、immich-change-domain.sh スクリプトを使用します。

# /root/immich-change-domain.sh -d new-domain.com

Step 7: 動作確認

システムの状態を確認するには診断スクリプトを実行します。

# /root/immich-diagnose.sh

管理スクリプト一覧

スクリプト名 機能 使用例
immich-manage.sh setup Dockerイメージのダウンロード（初回のみ） # /root/immich-manage.sh setup
immich-manage.sh start サービス起動 # /root/immich-manage.sh start
immich-manage.sh stop サービス停止 # /root/immich-manage.sh stop
immich-manage.sh restart サービス再起動 # /root/immich-manage.sh restart
immich-manage.sh status 稼働状況の確認 # /root/immich-manage.sh status
immich-manage.sh logs ログの表示 # /root/immich-manage.sh logs
immich-diagnose.sh システム診断 # /root/immich-diagnose.sh
immich-letsencrypt.sh Let’s Encrypt SSL証明書の取得 # /root/immich-letsencrypt.sh -e [email protected] -d your-domain.com
immich-change-domain.sh ドメインの変更 # /root/immich-change-domain.sh -d new-domain.com

セキュリティグループ設定

ポート番号 プロトコル 用途 必須/オプション
22 TCP SSH 任意
80 TCP HTTP（HTTPSへリダイレクト） 必須
443 TCP HTTPS 推奨

アプリケーションの具体的な利用方法につきましては、サービス開発元やサービス提供元の公式サイト、Wikiなどで最新情報をご確認ください。

サイト名 URL 説明
Immich公式サイト https://immich.app/ プロダクト情報・最新ニュース
Immich公式ドキュメント https://immich.app/docs/ 技術ドキュメント・チュートリアル
ImmichのGitHubリポジトリ https://github.com/immich-app/immich ソースコード・イシュートラッカー

おトクなキャンペーン情報