Installation guide

From a clean server to the first channel.

1. Requirements

Ubuntu 24.04 or newer, or Debian 12 or newer, on x86-64.
Root access (sudo).
Open ports: 80 and 443 for streams, 8088 for the admin panel. All three can be changed later in the settings.
A license key. A free trial key is issued in your account right after registration.

2. Install the package

From the repository (recommended)

Updates then arrive with a normal apt upgrade.

curl -fsSL https://streamax.media/repo/streamax.gpg | sudo tee /usr/share/keyrings/streamax.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/streamax.gpg] https://streamax.media/repo stable main" | sudo tee /etc/apt/sources.list.d/streamax.list
sudo apt update && sudo apt install stream-hub

From a downloaded package

Take the install command for the current version from the Downloads page, or download the .deb there and run:

sudo apt install ./stream-hub_VERSION_amd64.deb

ffmpeg and the libraries it needs are inside the package. The package, its service and its directories are named stream-hub.

3. Enter the license key

The installer asks for the key. To set or change it later, put the 64-character key into the license file and restart the service:

sudo nano /etc/stream-hub/license.key
sudo systemctl restart stream-hub

The server must be able to reach the license service over HTTPS. A key works with the application version it was issued for.

4. Start and open the admin panel

sudo systemctl enable --now stream-hub
sudo systemctl status stream-hub

Open http://SERVER_ADDRESS:8088/admin in a browser. The first login is admin / admin123.

Change the admin password right away: Settings → Authorization. Restrict the panel to your addresses there as well.

5. Add the first channel

Press Add stream, give the channel a name and the address of its source.
Save. The channel appears in the list with its state and bitrate.
The playback addresses for HLS and DASH are shown in the channel card.

6. HTTPS

Point a domain name at the server, then request a certificate in Settings → SSL. The panel and the streams switch to HTTPS on port 443.

Files and commands

`/etc/stream-hub/settings.json`	server settings
`/etc/stream-hub/channels.json`	channels
`/etc/stream-hub/license.key`	license key
`/var/lib/stream-hub/`	data: archive index, statistics, cache
`sudo systemctl restart stream-hub`	restart the server
`sudo journalctl -u stream-hub -f`	follow the log

Updating

Check News and the changelog on the Downloads page.
If the new version has another number, first get the key for it in your account (License → Get key for the new version) and put it into /etc/stream-hub/license.key.
Install the new package the same way as the first time, or run sudo apt update && sudo apt upgrade if you use the repository. Settings and channels are kept.

Removing

sudo apt remove stream-hub

Settings in /etc/stream-hub and data in /var/lib/stream-hub stay on disk. Release the server's slot in your account if you want to use the license elsewhere.

Help

Something does not work? Write to support and include the output of sudo journalctl -u stream-hub -n 100.