VPSにPostHogをセルフホストする方法（完全ガイド）

PostHogは、アプリケーションをセルフホスティングしながらデータを管理したい開発者向けに設計された強力な分析プラットフォームです。このガイドでは、Virtual Private Server（VPS）にPostHogをインストールするためのステップを詳しく解説します。プロバイダーの選び方からDockerを使ったPostHogアプリケーションの実行まで、すべてをカバーします。

VPSプロバイダーの選び方

インストールに入る前に、VPSプロバイダーを選択する必要があります。以下は、開発者やホームラボユーザーにも人気のオプションです。

詳しいVPS比較については、full VPS comparisonを参照してください。

事前準備

1. VPSのセットアップ：VPSがUbuntu 20.04以上で動作していることを確認してください。
2. ドメイン：PostHogインスタンスへのアクセスを容易にするためにドメイン名を取得することを推奨します。
3. DockerとDocker Compose：VPSにDockerとDocker Composeがインストールされている必要があります。

DockerとDocker Composeのインストールには、次のコマンドを使用します。

sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install -y docker-ce
sudo apt install -y docker-compose

PostHogのインストール

環境構築が完了したら、PostHogのインストールを進めましょう。

1. リポジトリのクローン

ターミナルを開き、以下のコマンドでPostHogリポジトリをクローンします。

git clone https://github.com/PostHog/posthog.git
cd posthog

2. .envファイルの作成

クローンしたディレクトリのルートに.envファイルを作成し、PostHogの設定を記述します。基本的な例は以下の通りです。

# PostHog設定
POSTHOG_INSTANCE_ID=your_instance_id
POSTHOG_SECRET_KEY=your_secret_key
# RedisとPostgreSQLの設定は必要に応じて調整してください

3. Docker Composeの設定

次に、docker-compose.ymlファイルを作成します。以下はサンプルです。

version: '3.8'
services:
  web:
    image: posthog/posthog
    env_file: .env
    ports:
      - "8000:8000"
    depends_on:
      - redis
      - postgres
      
  redis:
    image: redis:6.0
    ports:
      - "6379:6379"

  postgres:
    image: postgres:13
    environment:
      POSTGRES_DB: posthog
      POSTGRES_USER: posthog
      POSTGRES_PASSWORD: your_postgres_password
    ports:
      - "5432:5432"

networks:
  default:
    driver: bridge

4. サービスの起動

次に、Docker Composeを使ってPostHogを起動します。

docker-compose up -d

このコマンドは必要なイメージをダウンロードし、サービスをデタッチモードで起動します。

5. PostHogにアクセス

Webブラウザを開き、http://your-domain-or-ip:8000にアクセスしてください。PostHogのインターフェースが表示され、データの追跡を始められます。

PostHogの設定

PostHogが起動したら、初期設定を行うことができます。

1. ユーザー認証：アカウントを作成し、アクセス権を管理します。
2. アプリとの連携：PostHog JavaScriptライブラリを使って、アプリにトラッキングを追加します。
3. データ管理：ダッシュボードを活用してイベントやプロパティを管理します。

FAQ

低スペックのVPSでPostHogを動かせますか？

もちろんです。PostHogは低スペックのVPSでも動作しますが、パフォーマンスは追跡するイベント数や同時ユーザー数によって異なります。初心者の場合、Hetzner CloudやContaboのようなコストパフォーマンスの良いプランを選ぶと良いでしょう。これらは小規模から中規模のインストールに十分なリソースを提供します。

PostHogを別のVPSへ移行するにはどうすればよいですか？

PostHogを別のVPSに移行するには、データベースと設定ファイルのバックアップが必要です。PostgreSQLデータベースはpg_dumpを使ってエクスポートし、新しいサーバーに転送してpsqlでリストアします。.envファイルとdocker-compose.ymlも新環境に移動してください。

自ホストのPostHogは安全ですか？

適切なセキュリティ対策を講じれば、自己ホストのPostHogは安全です。例えば、HTTPSの利用、ファイアウォールの設定、最新のソフトウェアへのアップデートなどが重要です。PostgreSQLとRedisのインスタンスも適切に保護し、Let’s Encryptを使ったSSL証明書を導入して暗号化通信を確保してください。

まとめ

VPSにPostHogをセルフホストすることで、分析データを完全に管理でき、コストも抑えられます。このガイドに従えば、迅速にセットアップしてアプリケーションの分析を始めることができます。問題が発生した場合は、r/selfhostedコミュニティやawesome-selfhostedリポジトリが、トラブルシューティングや追加ツールの探索に役立ちます。ハッピーセルフホスティング！