Files

T

Alessandro RosandGitHub a56408db19 add always available streams (#5335 )

When the publisher or source of a stream is offline, the server can be
configured to fill gaps in the stream with a video that is played on
repeat until a publisher comes back online. This allows readers to stay
connected regardless of the state of the stream. The offline video and
any future online stream are concatenated without decoding or
re-encoding packets, using the original codec.

2026-01-31 14:44:58 +01:00

3.4 KiB

Raw Blame History

Install

There are several installation methods available: standalone binary, Docker image, Arch Linux package, FreeBSD or OpenWrt binary.

Standalone binary

Visit the Releases page on GitHub, download and extract a standalone binary that corresponds to your operating system and architecture (example: mediamtx_{version_tag}_linux_amd64.tar.gz).
Start the server by double clicking on mediamtx (mediamtx.exe on Windows) or writing in the terminal:
```
./mediamtx
```

Docker image

Download and launch the bluenviron/mediamtx:1 image with the following environment variables and ports:

docker run --rm -it \
-e MTX_RTSPTRANSPORTS=tcp \
-e MTX_WEBRTCADDITIONALHOSTS=192.168.x.x \
-p 8554:8554 \
-p 1935:1935 \
-p 8888:8888 \
-p 8889:8889 \
-p 8890:8890/udp \
-p 8189:8189/udp \
bluenviron/mediamtx:1

Fill the MTX_WEBRTCADDITIONALHOSTS environment variable with the IP that will be used to connect to the server.

The MTX_RTSPTRANSPORTS=tcp environment variable is meant to disable the UDP transport protocol of the RTSP server (which require the real IP address and port of incoming UDP packets, that are sometimes replaced by the Docker network stack). If you want to use it, you need to bypass the Docker network stack through the --network=host flag (which is not compatible with Windows, macOS and Kubernetes):

docker run --rm -it --network=host bluenviron/mediamtx:1

There are four image variants:

name	FFmpeg included	RPI Camera support
bluenviron/mediamtx:1	❌	❌
bluenviron/mediamtx:1-ffmpeg	✔️	❌
bluenviron/mediamtx:1-rpi	❌	✔️
bluenviron/mediamtx:1-ffmpeg-rpi	✔️	✔️

The 1 tag corresponds to the latest 1.x.x release, that should guarantee backward compatibility when upgrading. It is also possible to bind the image to a specific release, by using the release name as tag (bluenviron/mediamtx:{docker_version_tag}).

The base image does not contain any utility, in order to minimize size and frequency of updates. If you need additional software (like curl, wget, GStreamer), you can build a custom image by using the MediaMTX image as a base stage, by creating a file name Dockerfile with this content:

FROM bluenviron/mediamtx:1 AS mediamtx
FROM ubuntu:24.04

COPY --from=mediamtx /mediamtx /
COPY --from=mediamtx.yml /

RUN apt update && apt install -y \
   (insert here additional utilities)

ENTRYPOINT [ "/mediamtx" ]

And then build it:

docker build . -t my-mediamtx

Arch Linux package

If you are running the Arch Linux distribution, launch:

git clone https://aur.archlinux.org/mediamtx.git
cd mediamtx
makepkg -si

FreeBSD

Available via ports tree or using packages (2025Q2 and later) as listed below:

cd /usr/ports/multimedia/mediamtx && make install clean
pkg install mediamtx

OpenWrt binary

If the architecture of the OpenWrt device is amd64, armv6, armv7 or arm64, use the standalone binary method and download a Linux binary that corresponds to your architecture.

Otherwise, compile the server from source.

3.4 KiB Raw Blame History