RTMP ingest¶

Sapsan can pull an RTMP stream from another server in client (pull) mode. For accepting incoming RTMP publishing (push into Sapsan), see publishing.

Configuration¶

streams:
  relay:
    inputs:
    - rtmp:
        url: rtmp://origin.example.com/live/streamkey
        peer_timeout_ms: 5000

If the server requires authentication, put the login and password in the URL: rtmp://user:password@origin.example.com/live/streamkey — the multi-stage Adobe/FMS authentication (authmod=adobe) is supported.

Codecs¶

H264 + AAC, HEVC (enhanced RTMP), audio-only streams. Broken metadata (onMetaData) does not break ingest.

Error behavior¶

Server rejection codes are distinguished and visible in the input status: stream not found, access denied, stream stopped, protocol error. A dropped connection and a silent server (peer_timeout_ms) are also distinguished. LSI switches to a backup input on any of these.

Applying changes¶

Changing url restarts the source; changing only peer_timeout_ms applies in place.

Next steps¶

• Set up a backup source
• Restream further over RTMP