Skip to main content

Installation

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.

Linux specific instructions

MistServer as a 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

From the binaries

We recommend booting MistServer by the use of a terminal. Open a terminal window, browse to the folder where you've unpacked the binaries and run the MistController.

Windows specific instructions

For the best experience when using MistServer in Windows we recommend using the command prompt and running MistController.exe. If you are not familiar with the command prompt simply double click on MistController.exe. Several windows popping up is normal behaviour for MistServer in some versions of Windows, so do not get alarmed if this happens.

MacOS specific instructions

MistServer in MacOS requires permissions to create temporarily files, as such running MistServer as root is recommended. The easiest way to do this is to boot MistController from the Terminal using sudo. You can do this by opening the Terminal, typing sudo and dragging the MistController inside the terminal window. Make sure there is a space between sudo and the file path. You will be promped to enter the root password before you can continue.

Docker specific instructions

It's recommended to set a good amount of RAM depending on your hardware. We recommend using 95% if this is a dedicated server. Otherwise we would recommend at least 50% of your RAM. In the interest of keeping this quick and simple the --shm-size=### flag has been set to use 4GB of your RAM.

Set up the following values!

  • /PATH/TO/CONFIG.JSON Host location where you want to store the MistServer configuration.
  • /FOLDER/WITH/VIDEOFILES Host location where VoD content is available
  • 4g Amount of shared memory available to the docker image
docker run --detach --mount type=bind,source=/PATH/TO/CONFIG.JSON,destination=/config.json --mount type=bind,source=/FOLDER/WITH/VIDEOFILES,destination=/video --shm-size=4g --network=host ddvtech/mistserver

For more details please visit our official dockerhub page