Back up and restore OpenStream TV

OpenStream TV’s data directory can contain provider sessions, the admin password hash, IPTV access key, device identity and TLS private key. Treat a backup as secret. Do not upload it to a public repository or share it in support logs.

Find the data directory

The default is under the account’s home directory. OPENSTREAM_PATH_PREFIX or the path_prefix configuration setting can change it. OpenWrt uses /etc/openstream; Docker stores it in /app/.openstream-tv inside the container, usually backed by a named volume. See Data files, backups and logs.

Back up

Stop the server first so state files do not change during the copy. Use the relevant service or container controls, then copy the entire configured data directory to private storage while preserving file permissions. On OpenWrt, include both /etc/openstream and /etc/config/openstream. For Docker, back up the mounted volume while the container is stopped. Store backups encrypted or in a location accessible only to you.

Restore

Stop OpenStream TV, restore the complete directory and its permissions, and ensure the service uses the same OPENSTREAM_PATH_PREFIX. On OpenWrt restore both the application data and UCI configuration. Start the service and confirm that admin login, provider account status, TLS access and playlist links work. Rotate the IPTV access key if its URL may have been exposed.