The primary goal of this quick start tutorial is to introduce you to Flussonic Media Server. By the end of this tutorial you will learn how to:
- Install Flussonic Media Server
- Configure and view a video stream
- Publish video to Flussonic
- Upload and view a video file
In this documentation, we will use placeholder IP addresses (or URLs) of the Flussonic server (such as FLUSSONIC-IP). Please replace placeholder IP addresses with the actual IP addresses used on your server.
Flussonic Media Server
Flussonic Media Server is software for video streaming server capable of a wide variety of tasks including mass storage, transcoding, live and on-demand video delivery and control over video consuming and video streams.
We will demonstrate all main scenarios using Flussonic web interface. However, if you prefer to use API, please refer to Flussonic API reference.
Installing Flussonic Media Server
This section briefly describes how to install Flussonic Media Server so that you can install it quickly.
To install and configure Flussonic Media Server, you will need a computer with Linux connected to the Internet, and a license or trial key. A trial key can be requested on this page.
The main requirement is that the system must be 64-bit. We strongly recommend using Ubuntu Server. You can find the whole list of system requirements here.
Despite the fact that Flussonic Media Server will work on Ubuntu Desktop, we do not recommend using it, because Ubuntu Desktop has its own features with power management, energy saving, Network-manager and background updates, and other differences that may affect on performance. It is also possible that some third-party software and drivers may not work on it.
If you don't have an available suitable system at hand, you could rent a small cloud instance at Digital Ocean for the time needed to try out our software.
To install Flussonic Media Server you will need access to a Linux console as the 'root' user on your server.
Run the following command in the Linux console (command line):
curl -sSf https://flussonic.com/public/install.sh | sh
Then start Flussonic Media Server:
service flussonic start
Now you can open the Flussonic administrator's web interface in a web browser.
The first run of the Flussonic user interface (UI)
The Flussonic user interface is available at
FLUSSONIC-IP with the real IP address of your server).
On the start page Flussonic asks you to enter the administrator's username and password and the license key that you have received.
Both login and password must NOT include any of the following characters: @, ;, #, [, \, /, =
Checking the installation
You can check whether your Flussonic installation is correct by visiting
FLUSSONIC-IP is the address of the server on which you installed the software. The Flussonic administrator's web interface opens if the installation was correct.
- The detailed instruction on how to install the software can be found in the Installation section.
- How to configure Flussonic is described in Administration > Configuring Flussonic Media Server.
Flussonic can receive streaming video in two main ways: acting as a client or a server.
When acting as a client, Flussonic connects to a video source to retrieve the data. When acting as a server, Flussonic waits for external systems to connect and then it receives video for publication. Here, we will describe ingesting video when Flussonic acts as a client.
A video source can be an IP camera, other video streaming server, a specialized program working with a DVB card, and almost any system that can stream video over the network. Flussonic supports all major video transfer protocols.
In addition, Flussonic can generate a sample video stream
fake://fake. This stream can be used, for example, to test the system health.
To add a live stream, go to Media > click Add stream. Specify a stream name (
demo) and a source URL (
fake://fake). Click Create.
Now open the address
http://IP:80/demo/embed.html in the browser and see the result.
To view all the links for playing the stream via various protocols, go to Media > click the name of the created stream (
demo) > go to the Output tab.
- Learn more about live video in the Live streaming section.
Publication is a process where an external system connects to Flussonic Media Server and initiates the transmission of streaming video to Flussonic Media Server. To make this possible, you will need to configure a stream or a publishing location on the Flussonic server where you allow publication.
This can be done in two ways depending on whether you know the stream name in advance or not.
You know the stream name
Let’s assume you know the name of the published stream in advance (e.g.,
To allow the publication into a certain separate stream, go to Media > click Add stream. Specify a stream name (
published) and a special
publish:// option as a source URL. Click Create.
In this case you can publish the video stream via RTMP to this URL:
To view all the links for publishing video, go to Media > click the name of the created stream (
published) > see the Published section on the Overview tab.
Let's publish the video by using the RTMP protocol. We will use the file
/opt/flussonic/priv/bunny.mp4 as a source (this file is already included into the distribution package). We will publish video by using a special command-line utility for working with video streams. This tool is installed as the
rtmp_push package and located in the
Run the following command:
/opt/flussonic/contrib/rtmp_push /opt/flussonic/priv/bunny.mp4 rtmp://FLUSSONIC-IP:1935/static/published
Publishing of the video will start. Play it back at the URL:
You don't know the stream name
You will need to configure a template with a publication prefix where you allow publication. A single publishing location will be used to publish one or more streams. The prefix is used to form a stream name. The general structure for a stream name is as follows:
To create a template go to Media > Templates > click Add template. Specify a template name (
live-mylive) and a special
publish:// option as a source URL. Click Create.
Then click the name of the created template, and in Template settings specify a prefix (
mylive). Then click Save and apply to streams.
If you configured the prefix
mylive, then you must specify the stream name that starts with
mylive/ in the URL, for example,
mylive/bunny. The stream name that goes after the prefix is defined by the client app that publishes video.
Let's transmit video by using the RTMP protocol. We will use the file
/opt/flussonic/priv/bunny.mp4 as a source (this file is already included into the distribution package). Run the following command:
/opt/flussonic/contrib/rtmp_push /opt/flussonic/priv/bunny.mp4 rtmp://FLUSSONIC-IP:1935/mylive/bunny
Publishing will start. On the Media tab, you can see a stream for publishing that is automatically generated from the template:
To see the result, open this address in the browser:
- Refer to the Publishing section to learn more about publishing video streams to Flussonic.
In this section you will learn how to play a video file using Flussonic. For playing files, Flussonic uses VOD (Video On Demand) service — an integral part of services based on video delivery. To play a file, you will need to:
- Set up file location
- Upload a file
- Open the file in a player
Setting up a file location
Flussonic doesn't have a predefined location for files. You can store video files in different paths on your disk. And you will need to explicitly specify where the system should find them.
For this, you need to add a VOD location and to specify how the path in requests for the file playback should match the real file on the disk or in an HTTP repository. Based on these settings, Flussonic defines the path to a file. This path will be used in requests for playing back the file via various protocols.
To add a VOD location, go to Media > VODs > click Add VOD > enter VOD name (
vod1) and File directory path (
/storage) > click Create.
Now Flussonic knows that when clients request
vod1/movies/bunny.mp4, it will need to access the file
/storage/movies/bunny.mp4. In other words, everything after the prefix
vod1 will be cut and added to the specified path on the disk (that starts with
/storage in our example).
Uploading a file
Now you can upload the file you have prepared to the directory
The Flussonic distribution package includes a test file
If you do not have this video, you can download freely available Big Buck Bunny video clip:
mkdir -p /storage cd /storage curl -o bunny.mp4 https://download.atmark-techno.com/sample/bbb/big-buck-bunny-30sec-fullhd.mp4
To upload the file via Flussonic UI, go to Media > VODs > click the name of the created VOD location (
vod1) > click browse > click Upload Files > select the file to upload (
Playing the file
Open this link:
http://FLUSSONIC-IP:80/vod1/bunny.mp4/embed.html and watch the video.
To view all other links for playing the file, go to Media > VODs > click the name of the created VOD location (
vod1) > click browse > click the name of the file. Below you will see the embedded player for playing the file, the HTML code for using in a player on your site or in your application, and the list of the links for playing the file via various protocols.
- Learn more about video files in the VOD Files page.