Skip to content

Upgrade guide

Important note!

Before upgrading Quickstream please remember to:

  • Notify your clients/partners about planned maintenance. Upgrade causes a short break in Quickstream Node transmission.
  • Read changelogs and release notes before the upgrade
  • Make sure your system is still supported. We do not delete old packages, so your Node will not upgrade if installed on an unsupported operating system. Windows version of Quickstream Node may be installed on an unsupported operating system but may not work correctly.
  • Perform a backup of your configuration. Please refer to backing up Quickstream for more information.

Upgrade from version 4 (or earlier) to version 5

Upgrading Quickstream Node to version 5 from an older version of Quickstream Node differs from the previous updates. Quickstream Node 5 installs in parallel with version 4 or earlier. This means you can use version 5 together with an older on the same system. Please follow the installation instructions from here. To make the migration easier, we have developed an importer that lets you import channels from previous versions. If you perform import, you can quickly stop channels on your old version and start them immediately on a new one. In case of any problems, reverting the operation is very easy.

After a successful upgrade, you may delete Quickstream Node version 4.

Upgrade to the latest 5 version

Upgrading Quickstream Node on Linux-based operating systems

Superuser permissions required

Blocking packages from accidental upgrade

If you want to protect Quickstream Node from accidental upgrade, you can hold all quickstream5* packages using the following command:

sudo apt-mark hold 'quickstream5*'

To un-protect Quickstream Node use the following command:

sudo apt-mark unhold 'quickstream5*'

Update your apt cache index. Please note that this command will NOT update your system. It will only update the cache index.

sudo apt update

Upgrade Quickstream Node package. This command will ONLY upgrade Quickstream Node and its dependencies.

sudo apt install quickstream5

Check if the service is running and check if you can manage your Node using Quickstream Cloud or Quickstream Client.

systemctl status quickstream5.service

The output should look like this.

● quickstream5.service - Quickstream 5
     Loaded: loaded (/usr/lib/systemd/system/quickstream5.service; enabled; preset: enabled)
     Active: active (running) since Wed 2024-08-21 09:24:19 CEST; 3h 17min ago
    Process: 1885 ExecStart=/opt/quickstream5/bin/quickstream5 --start-daemon (code=exited, status=0/SUCCESS)
   Main PID: 1942 (quickstream5)
      Tasks: 10 (limit: 38231)
     Memory: 57.1M (peak: 58.5M)
        CPU: 14.948s
     CGroup: /system.slice/quickstream5.service
             ├─1942 /opt/quickstream5/bin/quickstream5 --start-daemon
             └─2803 /opt/quickstream5/bin/quickstream5-engine-transcoding channelId 3

Upgrading Quickstream Node on Windows

Please follow same instructions as for installation guide. It will not remove current configuration!