PhotoPrism

最終更新日: 2026年3月26日

目次

テンプレート説明

PhotoPrismは、AIを活用した写真管理アプリケーションです。RAW画像や動画を含む多様なフォーマットに対応し、自動タグ付け・顔認識・地図表示などの機能を通じて、プライベートな写真ライブラリをセルフホストで管理できます。

本テンプレートはインストール完了後もサービスは停止状態を維持します。利用を開始するには、SSHでサーバーに接続し、管理スクリプトでセットアップと起動を行ってください。

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

メモ

PhotoPrismのコミュニティエディション（CE）はAGPL-3.0で提供されるオープンソースソフトウェアです。本スクリプトはお客様によるPhotoPrismのインストールを支援するためのものであり、Dockerイメージ（photoprism/photoprism:ce）はお客様の環境に直接取得されます。詳細はOpen Source FAQをご確認ください。

仕様

対応OSイメージ

Ubuntu 24.04 LTS

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
PhotoPrism Latest AGPL-3.0 写真管理アプリケーション本体
MariaDB 11 GPLv2 データベース
Docker Engine Latest Apache 2.0 コンテナランタイム
Docker Compose Latest Apache 2.0 コンテナオーケストレーション
Nginx Latest BSD-2-Clause リバースプロキシ・TLS終端

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

項目 説明
アプリケーション利用ポート 80/tcp (HTTP), 443/tcp (HTTPS)
インストールディレクトリ /opt/photoprism
管理スクリプト /root/photoprism-*.sh
初期状態 サービス停止中（セキュリティのため）

その他

最小システム要件

  • CPU: 2コア以上推奨
  • メモリ: 最小2GB、推奨4GB以上
  • ディスク容量: 写真ライブラリ・サムネイル・DB用に十分な空き容量（最小20GB以上推奨）
  • ネットワーク: パブリックIPアドレス

メモ

スタートアップスクリプトは自動的に4GBのスワップ領域を作成します。RAW画像や高解像度写真のインデックス作成時にはメモリを多く消費するため、スワップ領域の確保を推奨します。

利用手順

メモ

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

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

重要

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

Step 0: セキュリティグループについて

ConoHa VPS(Ver.3.0)ではサーバー毎にIPアドレスまたはポートでトラフィックを制御するセキュリティグループ(仮想ファイアウォール)が設定されます。本テンプレートをご利用の場合は、予め利用するポートの通信許可設定が必要です。詳細はセキュリティグループを参照してください。

Step 1: VPSへの接続

SSHクライアントを使用してVPSに接続します。

# ssh root@<サーバーIPアドレス>

Step 2: 初回セットアップ

Dockerイメージのダウンロードを行います。

# /root/photoprism-manage.sh setup

メモ

このコマンドはPhotoprismおよびMariaDBのDockerイメージをダウンロードします。ネットワーク環境によっては数分かかる場合があります。setupが完了するまで次のステップに進まないでください。

Step 3: サービスの起動

セットアップ完了後、サービスを起動します。

# /root/photoprism-manage.sh start

起動が完了すると、以下のURLでアクセスできます。

https://<サーバーのリバースDNSドメイン>

メモ

初期状態では自己署名証明書を使用しているため、ブラウザにセキュリティ警告が表示されます。Let’s Encrypt証明書の設定については、Step 5を参照してください。

Step 4: 初回ログインとパスワード変更

ブラウザでアクセスし、初期認証情報でログインします。

  • ユーザー名: admin
  • パスワード: /root/photoprism-info.txt に記載された初期パスワード

セキュリティ重要

初回ログイン後、必ず「Settings > Account」からパスワードを変更してください。初期パスワードはランダム生成されていますが、変更を強く推奨します。

Step 5: HTTPS設定（推奨）

独自ドメインとLet’s Encrypt証明書を使用してHTTPS接続を設定します。

事前にドメインのDNS設定でAレコードをサーバーのIPアドレスに向けてください。

# /root/photoprism-letsencrypt.sh -e [email protected]

独自ドメインを使用する場合は、先にドメインを変更してからLet’s Encryptを実行します。

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

Step 6: 動作確認

診断スクリプトでシステムの状態を確認します。

# /root/photoprism-diagnose.sh

管理スクリプト一覧

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

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

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

メモ

PhotoPrism本体（ポート2342）およびMariaDB（ポート3306）は外部に公開されません。Nginxがリバースプロキシとして動作し、外部からのアクセスはポート80/443のみ受け付けます。

バージョンアップ

PhotoPrismを最新バージョンに更新する手順です。写真データやデータベースはそのまま引き継がれます。

重要

バージョンアップ前に、写真データおよびデータベース（/opt/photoprism/database）のバックアップを取得することを推奨します。

  1. サービスを停止します。 
    # /root/photoprism-manage.sh stop
  2. 最新イメージを取得します。 
    # docker compose -f /opt/photoprism/docker-compose.yml pull
  3. サービスを起動します。 
    # /root/photoprism-manage.sh start
  4. バージョンアップ後の動作を確認します。 
    # /root/photoprism-diagnose.sh

Plus License版への変更

PhotoPrism Plusメンバーシップを取得済みの場合、ceタグからlatestタグ（Plus License版）に変更することで追加機能を利用できます。写真データおよびデータベースはそのまま引き継がれます。

メモ

PhotoPrism Plusメンバーシップの詳細および登録はPhotoPrism公式サイトをご確認ください。

  1. サービスを停止します。 
    # /root/photoprism-manage.sh stop
  2. イメージタグをlatestに変更します。 
    # sed -i 's|^PHOTOPRISM_IMAGE=.*|PHOTOPRISM_IMAGE=photoprism/photoprism:latest|' /opt/photoprism/.env
  3. 新しいイメージを取得します。 
    # docker compose -f /opt/photoprism/docker-compose.yml pull
  4. サービスを起動します。 
    # /root/photoprism-manage.sh start
  5. ブラウザでPhotoprismにアクセスし、メンバーシップのライセンスキーを有効化します。

メモ

ライセンスキーの有効化手順はPhotoPrism Activation Guideをご確認ください。

サイト名 URL 説明
PhotoPrism公式サイト https://www.photoprism.app/ プロダクト情報・最新ニュース
PhotoPrism公式ドキュメント https://docs.photoprism.app/ 技術ドキュメント・チュートリアル
PhotoPrism Docker Composeガイド https://docs.photoprism.app/getting-started/docker-compose/ Docker Composeを使ったセットアップ手順
PhotoPrism GitHubリポジトリ https://github.com/photoprism/photoprism ソースコード・イシュートラッカー

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