Changelog

Release notes and upgrade steps. Dates are approximate. This project grew out of a private production install before the public repo.

2025-12 v1.0.0 (public release)

First open-source drop. Everything below shipped together. Future releases will be smaller and dated.

VOD upload + FFmpeg transcode to HLS/DASH (Shaka Packager)
Live RTMP ingest via media-live, panel + API status
Shaka-based player: adaptive bitrate, subtitles, Chromecast, speed/quality controls
Admin panel: library, collections, metadata templates, users, encoding profiles
Client API: uploads, videos, collections, live streams, share links
Whisper.cpp transcription to VTT tracks
Share/embed: public + password links, email invites, domain/geo restrictions
AES-128 segment encryption at package time; playback via nixstream-edge signed URLs
Local disk or S3-compatible storage
Docker install.sh stack; manual Ubuntu 22.04 guide for bare metal

Install: getting-started or manual.

Pre-release history (internal)

Before v1.0.0 the stack ran in production on bitbyte3.com (120 TB+ encoded media, 2022-2025). The open-source tree is that codebase with internal bits stripped and docs added. Not a greenfield rewrite.

How to upgrade

Docker

cd nixstream/nixstream
git pull
docker compose pull
docker compose up -d --build
docker compose exec app php artisan migrate --force

Manual

Back up database and storage/ first.
Pull release files into your install dir.
composer install --no-dev --optimize-autoloader and npm ci && npm run build
php artisan migrate --force and php artisan config:cache
Restart queue workers and PHP-FPM.

See Backup and restore and Monitoring after upgrading.