Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Choose the Right Installation Method

OpenStream TV is a server. One device runs it, and a browser or IPTV application opens its interface or playlist over the network. For example, you can run the server on a Raspberry Pi and watch from a laptop on the same home network.

Choose your server device first:

Your deviceRecommended guide
Linux desktop or serverLinux
Mac desktop or laptopmacOS
Windows PCWindows
OpenWrt routerOpenWrt
Raspberry Pi or Linux mini-computerRaspberry Pi and SBC
Android with a terminal appTermux
Docker hostDocker and Compose
Existing downloaded executableManual binary
Developer with a Rust toolchainBuild from source

The full build serves the web interface. A slim build has no web interface and is for IPTV clients. JioTV+ is optional, stays off until it is enabled, and needs a separate account; select the full build if this is your first installation.

What each installation method installs

MethodVersion behaviorCommand you run afterward
Linux, macOS, or Termux installerDownloads the latest GitHub release by default. Set OPENSTREAM_VERSION to pin a release.ost
Windows PowerShell installerDownloads the latest GitHub release by default. Use -Version or OPENSTREAM_VERSION to pin a release.ost (ost.exe on disk)
OpenWrt installerInstalls the matching openstream or openstream-slim package from the latest GitHub release by default. OPENSTREAM_VERSION can select a release./usr/bin/ost
Docker or Composeghcr.io/wpfyorg/openstream-tv:latest tracks the current full image; :slim tracks the slim image. Use a versioned tag when you need a fixed release./usr/local/bin/ost inside the container
Manual binaryUses the exact GitHub release asset you download and verify. Install or rename it as ost.ost
Build from sourceBuilds the revision currently checked out. That revision can be newer than the latest release.target/release/ost before installation

If you need reproducible deployments, pin a release or container tag instead of following latest.

The Linux, macOS, Windows and OpenWrt installers run a guided setup when they have a terminal: choose the build, choose the account (JioTV, JioTV+, or Fastway when the release supports it), confirm the LAN address, decide whether to use a Cloudflare tunnel, and sign in. Docker and unattended installs skip it and use the documented environment variables instead.

Which provider you can use depends on the account: JioTV uses its mobile-number OTP flow, JioTV+ needs an eligible JioFiber or AirFiber login, and Fastway needs credentials accepted by the provider. ACT eligibility, where offered, depends on the provider.

After installing, use Getting Started in 5 Minutes. If your browser runs on another device, read Access OpenStream TV on your home network.