Files
mediamtx/docs/2-features/11-forward.md
T
98ab3009ea support forwarding streams natively (#5558)
It is now possible to define forward destinations for each path configuration. For each destination, the server will create a client that will forward the stream to the intended destination. Supported protocols are RTSP, RTMP, SRT. API and metrics have also been improved to allow monitoring the new forwarding system.

---------

Co-authored-by: aler9 <46489434+aler9@users.noreply.github.com>
2026-08-04 21:57:15 +02:00

1.0 KiB

Forward streams

Incoming streams can be natively forwarded to other servers with the following protocols:

It is also possible to use FFmpeg to perform the forwarding.

RTSP

Add the target URL inside dest of a forward entry:

paths:
  mypath:
    forward:
      - dest: rtsp://user:pass@host:port/path

RTMP

Add the target URL inside dest of a forward entry:

paths:
  mypath:
    forward:
      - dest: rtmp://user:pass@host:port/path#streamKey

SRT

Add the target URL inside dest of a forward entry:

paths:
  mypath:
    forward:
      - dest: srt://host:port?streamid=streamid

FFmpeg

When the destination requires transcoding, filtering or a protocol that is not supported by forward, use FFmpeg inside the runOnAvailable parameter instead:

pathDefaults:
  runOnAvailable: >
    ffmpeg -i rtsp://localhost:$RTSP_PORT/$MTX_PATH
    -c copy
    -f rtsp rtsp://other-server:8554/another-path
  runOnAvailableRestart: yes