BGPVR
Book a demoЗаявете демо

Operator Quick Start

A working BGPVR server delivering your first channels in about 15 minutes.
1

What you need

  • A Linux server you control — a small VPS or a home box. 2 CPU / 4 GB RAM is a fine start.
  • Docker with Docker Compose installed.
  • Optional: a domain name (for HTTPS and clean app URLs) and DVB tuner hardware for off-air TV — neither is required for M3U/IPTV sources.
2

Get your licence key

Your key and installation bundle (a docker-compose.yml plus registry access) arrive by email. Want to evaluate first? Email support@bgpvr.com for a trial key.

3

Install and start

mkdir bgpvr && cd bgpvr # place the docker-compose.yml from your welcome email here echo "BGPVR_LICENSE_KEY=YOUR-KEY-HERE" > .env docker compose up -d

On first boot BGPVR creates its database and generates its own secrets — nothing to configure by hand.

Server with an NVIDIA card? Once, on the server itself (not in the container), keep the card ready (persistence mode), so Light recordings start about a second sooner:

docker run --rm --entrypoint cat "$(docker inspect -f '{{.Image}}' bgpvr)" \ /app/scripts/host/gpu_persistence.sh > gpu_persistence.sh less gpu_persistence.sh sudo bash gpu_persistence.sh enable

Other systems (Unraid, TrueNAS, Synology) and the manual steps: operator manual → NVIDIA persistence mode.

4

First login

  • Open http://YOUR-SERVER-IP:8095/console.
  • Create the admin account on the first-run screen.
  • Your licence validates automatically and unlocks your tier. Brief internet outage? The suite keeps working on a grace period — the licence check is not a hard dependency for live TV.
5

Add your first channels

  • From an M3U playlist: Channels → Import M3U → paste the playlist URL of a source you have the rights to relay. Channels, groups and logos populate automatically.
  • From DVB tuners: Tuners → your adapters appear → run a Scan → map services to channels.
  • EPG: TV Guide → add an XMLTV URL or enable the built-in grabbers.
6

Create a package and a subscriber

  • Packages → Add Package → choose which channels and VOD it includes.
  • Clients → Add client → username + password, assign the package, set the connection limit.
7

Point apps at your server

  • BGPVR app (Android / Android TV / Fire TV): enter your server URL + the subscriber login.
  • Web player: http://YOUR-SERVER/tv/
  • Kodi (HTSP), Enigma2 and MAG / Stalker STBs are supported; LG webOS TVs: in LG’s review, developer-mode install until then; per-client URLs are under Settings → Client Access.
8

Going to production

  • Put the console behind HTTPS (reverse proxy + Let's Encrypt, or Cloudflare). Don't leave plain :8095 exposed to the internet long-term.
  • Update any time with docker compose pull && docker compose up -d.
  • Back up /data — the suite already writes a daily compressed database backup to /data/backups/.
Full operator manual: bgpvr.com/admin-help  ·  Support: support@bgpvr.com  ·  Terms: bgpvr.com/terms