Accessing the management interface and setting up MistServer
Using the default settings Mistserver can be reached at
http://host:4242
. If ran locally you can always use
http://localhost:4242
. Once logged in you can browse the panels with
the menu to the left, for the quickstart we will discuss the most minimal setup to get a stream.
Our Interface uses the API internally, which is also available on port 4242 by default. We recommend first time users to use the interface and when automation becomes important to start using the API directly, for that please look at our API documentation.
Creating your local MistServer account
The first time you connect to MistServer you will be prompted to create an account. This will be the information necessary to authorize any configuration changes within MistServer. You will also have the option to enable all default protocols, we recommend using this option if testing MistServer is your intent.
Protocol page
Protocols are necessary in order to both send streams towards MistServer as to view streams from MistServer. In order to use a streaming method it should be activated and the port should be available to MistServer.
If you have missed the opportunity to activate the default protocols you can do so again by selecting the Enable default protocols
button within the Protocol
page.
In order to maximize compatibility MistServer uses a non-standard HTTP
(TCP 8080) and RTSP
(TCP 5554) port. Any protocol that sends data over HTTP requires HTTP or HTTPS to be activated. SRT
has no default port, so we've chosen UDP 8889 for it.
VoD files are always accessible to MistServer, you do not need to activate MP4 in order to open MP4 files.
Streams page
The Streams
page is where you set up streams within MistServer. This page shows a quick overview on the streams currently set up and their status. You can create new streams by clicking the create a new stream
button.
When creating a new stream there are 2 key settings:
Stream name
:This is how MistServer identifies the stream internally and how you can quickly access the stream with your player.
Source
:This determines how MistServer should get to the stream data for the given stream name. This could be a live input or a media file.
Media files / VoD Sources
The only requirement here is to provide the path to the media file you want to stream. This file should be accessible as if available on a local disk. You can also select a folder to make all the streams within that folder available.
Live streams
Live streams are any type of source that are not locally stored within MistServer. Even if the source is a file on an outside location. These sources can be divided in 2 types:
Push inputs
Push inputs mean another server connects to MistServer and pushes in the stream data. MistServer waits for this device to make connection. Most incoming pushes can be set up using the following source:
push://(address)(@password)
address
: Optional, if used white-list only the given source to push this stream.
@password
: Optional, if used the push attempt must include this password.
in MistServer the following protocols can be used through push://
sources: RTMP
, RTSP
, SRT
, WebRTC
.
Some push inputs can or need to dedicate a specific port to the protocol. In this case a specific source needs to be given starting with the protocol scheme. These are srt://
for SRT
, rist://
for RIST
and tsudp://
for MPEG-TS over UDP
.
Directly below the source field will appear how to push using specific protocols.
The very easiest to push streaming setup is as follows:
push://
Then push using the following settings:
Protocol | Push target |
---|---|
RTMP | rtmp://address/live/streamname |
SRT | srt://address:8889?streamid=streamname |
RTSP | rtsp://address:5554/streamname |
Pull inputs
Pull inputs mean MistServer connects to an outside address and pulls in whatever stream is available at the given address. Simply fill in the address and watch the stream appear.