How to Update OpenStream TV

Before updating, note how OpenStream TV was installed and make a private backup of its data. Your login sessions, admin password, access keys and TLS files live in the data directory, separately from the binary.

Standalone Linux, macOS, Windows or Termux

1. Check the version shown in Settings or ost --help for available commands.
2. Stop the running foreground process or service. Record how it was started so you can use the same settings later.
3. Run ost update to fetch a matching release and verify its checksum. To choose a version, use ost update --version v1.5.0 (replace with the release you intend to install).
4. Restart OpenStream TV using your original command or service manager. On a systemd service, run sudo systemctl restart openstream (or systemctl --user restart openstream for a user service).
5. Open the app and check the version and whether Channels and Settings load.

Expected result: the new version runs with the existing configuration and account state. The updater needs access to its release source; private releases may require OPENSTREAM_UPDATE_TOKEN configured privately.

Docker

Pull the image used by your deployment and recreate the container using its existing environment and persistent volume. See Docker maintenance. Recreating a container without its prior volume can make data appear lost.

OpenWrt

Use the OpenWrt package installer or package manager to update the package, then check the procd service. The in-app ost update command is not intended to replace a package-managed binary. See OpenWrt maintenance.

If an update fails

Keep your original data backup. Collect the install method, exact version, error and relevant redacted logs. Avoid deleting data to fix an update. See update troubleshooting and uninstall safely.