Quick Start

Up and running in 3 minutes.

🇩🇪 Deutsche Version

Prerequisites

• Docker and Docker Compose installed on your host
• Port 3000 free and accessible
• A working internet connection (to pull the image from GHCR)

One-liner (Docker)

docker run -d \
  --name itsweber-play \
  -p 3000:3000 \
  -v play-data:/data \
  -e BASE_URL=http://localhost:3000 \
  -e INITIAL_ADMIN_EMAIL=admin@example.com \
  ghcr.io/itsweber-official/itsweber-play:main

This pulls the latest release, starts all internal services (Postgres, Redis, MinIO, API, Worker, Web, Nginx) inside a single container, and stores all persistent data in the play-data Docker volume.

Open in Browser

Navigate to http://localhost:3000.

The first-run wizard will appear automatically on the first visit when no admin account exists yet.

First-run Wizard Steps

1. Admin account — Confirm the admin email set via INITIAL_ADMIN_EMAIL and choose a password.
2. Instance name — Set the display name shown in the header and browser title.
3. Logo — Upload a custom logo or skip to use the default.
4. First channel — Create your first channel to start uploading videos.

Once the wizard is complete you are taken directly to the Studio dashboard.

What's Next?

Production Note

The one-liner above is suitable for local testing. For a production deployment:

• Set BASE_URL to your real public URL (e.g. https://play.example.com)
• Configure email delivery via SMTP_* environment variables so password reset and notifications work
• Place the container behind a reverse proxy (Nginx, Traefik, Caddy) that handles TLS termination
• HTTPS is strongly recommended — browser upload APIs and session cookies require a secure context for full functionality

See Configuration for the full list of environment variables.