Install guide

Get PrivatePlayHub running on your own VPS in about 5 minutes.

Server requirements

  • • Linux VPS (Ubuntu 22.04+ recommended)
  • • 2 vCPU / 4GB RAM minimum (4 vCPU / 8GB for 4K)
  • • 50GB+ disk (depends on your library)
  • • Docker + Docker Compose
  • • A domain pointing to your server

1. Get a license key

Sign up free on the dashboard. You'll get a license key (starts with PPH-). Even the free tier requires one.

2. Download & unzip

# from your dashboard's Downloads page
wget https://privateplayhub.com/dashboard/downloads/privateplayhub-cms-latest.zip
unzip privateplayhub-cms-latest.zip
cd privateplayhub-cms

3. Configure

cp .env.example .env
# edit .env: set SECRET_KEY, DOMAIN, ADMIN_PASSWORD, etc.
nano .env

4. Launch

docker compose up -d
# runs postgres, redis, web, celery, nginx

5. Activate your license

docker compose exec web flask license-activate \
  --key PPH-XXXX-XXXX-XXXX-XXXX \
  --domain https://videos.yourdomain.com

That's it. Open https://videos.yourdomain.com/ and log in with your admin credentials.

Why does the script phone home?

License validation + entitlement delivery + revocation. The CMS verifies a signed token from our license server every 12–24h. If the server is unreachable, a 7-day offline grace keeps you running. We never see or store your videos — only anonymous install metadata.

Need help?

Email support@privateplayhub.com or check the FAQ.