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

Install with Docker

The published image supports Linux amd64, arm64, ARMv7 and 386. Docker selects the matching architecture. The latest tag tracks the current full image and slim tracks the current slim image. For a fixed release, use a versioned tag such as 1.5.0 for full or 1.5.0-slim for slim.

Create and start a container with a persistent named volume:

docker run -d --name openstream --restart unless-stopped \
  -p 5001:5001 -p 5443:5443 \
  -v openstream-data:/app/.openstream-tv \
  ghcr.io/wpfyorg/openstream-tv:latest

The container starts the server on all interfaces with HTTPS enabled. On the Docker host, open https://localhost:5443/; from another trusted LAN device, use https://<docker-host-ip>:5443/. Accept the self-signed certificate warning. IPTV players use the HTTP playlist on port 5001. Keep both the container and volume private; the volume contains credentials and the generated TLS key.

Set the admin password from the container’s terminal, then sign in to the web interface and complete JioTV OTP login:

docker exec -it openstream /usr/local/bin/ost admin password

View output with docker logs -f openstream. For updates and backup instructions, see Docker maintenance.

To run headless, use ghcr.io/wpfyorg/openstream-tv:slim. To pass configuration, add supported options such as -e OPENSTREAM_TITLE="Living Room TV" before the image name. Container arguments replace the image’s default command, so preserve --skip-update-check serve --host 0.0.0.0 --port 5001 --tls --tls-port 5443 when setting a custom command. See CLI options.

Verify and troubleshoot

Run docker ps --filter name=openstream to confirm the container is running and docker logs --tail 50 openstream to inspect startup messages. Open the HTTPS page at the host’s configured port. If the port is occupied, choose a different host-side port mapping; if saved accounts disappear after recreation, confirm the openstream-data volume was retained.

Use Docker maintenance to pull updates, back up the volume and uninstall the container. For network errors see Docker and web troubleshooting.