Flussonic Media Server documentation


Load Balancer

Flussonic Media Server (IPTV Plugin) can balance users between several Flussonic Media Server nodes using cluster peering mechanism.

It will redirect users from load balancer node (that don't have any streams) to other servers.

Important! The balancer is installed ONLY on a separate server and requires an additional license.


Enable loadbalancer and set multiple Flussonic Media Server peers:

# Global settings
http 8080;
cluster_key somekey;

peer peer1.example.com;
peer peer2.example.com;
peer peer3.example.com;

plugin iptv {
  database sqlite:///opt/flussonic/priv/iptv.db;
  loadbalance bitrate;

You need to set same cluster_key on all cluster hosts.

Peer config example:

# Global settings
http 8080;
cluster_key somekey;

source origin.example.com {

Loadbalancer have 2 modes: bitrate and usage. In bitrate mode Flussonic Media Server route users to peer where a lowest output bitrate. In usage the same thing, but with account of specified maximum bitrate (usage: output bitrate / max bitrate * 100).

All peer can have same streams, Flussonic Media Server will route clients to least loaded server.

Or all peers can have different streams, Flussonic Media Server will route clients to proper peers.

How to use the loadbalancer

Use the regular URLs for retrieving streams:

  • http://loadbalancer/STREAM/index.m3u8 - for HLS
  • http://loadbalancer/STREAM/mpegts - for HTTP MPEG-TS
  • rtmp://loadbalancer/static/STREAM - for RTMP

Loadbalancer know all the URLs that Flussonic Media Server provides for streams.

Server requirements

Virtual machine (VPS) with 1 CPU core and 1GB RAM will be enough in most cases. Our balancer only routing clients, not serving video streams.