Pushing a stream to other servers¶

How to copy (push) a stream to other servers¶

You can tell Flussonic to copy a stream to other servers by using the push directive. For example, you can push a stream to a CDN or to social media.

To use this function, go to the Output tab in the stream settings and scroll down to the Push live video to certain URLs section. Here you can add URLs to which Flussonic will push the stream.

Flussonic supports push over the following protocols:

RTMP¶

This protocol is usually utilized for pushing streams to the social networks. Please refer here for more details and examples.

HTTP MPEG-TS¶

This protocol is suitable for sending streams to third-party video streaming services. The publish link must be provided by the service you are pushing to.

HLS¶

You can push streams to a cloud or CDN using this protocol; usually CDNs support it. Below is an example of configuration for sending a stream to the Amazon AWS cloud.

Example: pushing a stream to Amazon AWS¶

stream breakingnews {
  input publish://;
  segment_count 10;
  segment_duration 10;
  push hlss://[api-id].execute-api.[aws-region].amazonaws.com/[stage]/[folder-name];
}

This config will allow you to use Amazon AWS API Gateway as a service proxy to Amazon S3 as described in Amazon's documentation.

M4S¶

Use this protocol to push streams to another Flussonic server. This is a persistent protocol that does not create delays and is used to transfer data from Flussonic to Flussonic for further delivery via WebRTC/RTMP.

M4S URL can be composed like that: m4s://FLUSSONIC-IP:PORT/STREAM_NAME.

Pushing with a 302 redirect¶

When publishing via m4s:// Flussonic will understand HTTP 302 and will follow to the specified address. This means that you can specify not only the Flussonic server address, but also your own backend for choosing a publishing location. For example, m4s://example.com/router;.

How to manage pushed streams¶

If the stream is configured to be pushed to an URL that has become offline, then Flussonic by default endlessly retries to push the stream to this URL.

Flussonic can monitor streams that it sends to other servers and collect statistics on unsuccessful sending attempts. A visual display of the push statuses in the UI will help you take action — stop (pause) offline streams or limit attempts to send them.

Push statuses are shown as indicators on the main page in the Streams list and in stream settings on the Output tab (Push live video to certain URLs). The reason for stopping the pushing process can be found in the logs.