Skip to main content

Installation

Compiling MistServer​

We consider compiling and running MistServer the most efficient way, due to the configurable nature of MistServer chances are you will want to make your own adjustments and run MistServer your way.

Dependencies​

  • C++ compiler
  • Meson
  • mbedtls (optional, automatically compiled as a subproject if SSL is enabled and mbedtls is not installed system-wide)
  • libsrt (optional, automatically compiled as a subproject if SRT is enabled and libsrt is not installed system-wide)
  • librist (optional, automatically compiled as a subproject if RIST is enabled and librist is not installed system-wide).

Easy compile command​

git clone https://github.com/DDVTECH/mistserver.git && cd mistserver && meson setup build -DNORIST=true && meson compile -C build

You will find the MistServer binaries within the mistserver/build folder. Should you wish to make MistServer available as a service please have a look at the service scripts included within the main directory.

Running MistServer​

MistServer can be ran without an installation as well. Simply boot up the MistController(.exe) when you download the binaries and you're good to go. The configurations will be saved in the same folder as config.json.

Do note that some of MistServer's automatic error recovery features will not function properly when not running as a system service.

What OS is best for MistServer?​

MistServer can run in every OS, however the clear winner is Linux with no meaningful difference between AMD and ARM. This is because MistServer relies heavily on shared memory to share stream data between processes and quickly and efficiently handle transformations between protocols and inputs. Windows and MacOS have a limited implementation in comparison and will take efficiency losses because of it.

Docker is a very close second as MistServer can run very efficiently in a dedicated environment thanks to Docker. The only reason it comes second is due to the slightly more complex setup in comparison to just running it on a server.

Choose your platform​

Linux specific instructions​

MistServer as a system service​

The easiest method to start with MistServer is to install it through the terminal. There's 2 requirements:

  • You are running the script as root
  • curl is installed

Install using:

curl -o - https://releases.mistserver.org/is/mistserver_64Vlatest.tar.gz 2>/dev/null | sh

Uninstall using:

curl -o - https://releases.mistserver.org/uninstallscript.sh 2>/dev/null | sh

Your configurations will be stored within /etc/mistserver.conf.

From the binaries​

Should you wish to run MistServer from a terminal download the latest binaries from https://r.mistserver.org/dl/mistserver_64Vlatest.tar.gz unpack the binaries and boot MistController.