You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Adolfo Delorenzo 2d7f7ba3c5
Update 'rtmp-server.yaml'
2 months ago
conf first commit 2 months ago
html updates 2 months ago
players first commit 2 months ago
Dockerfile updates 2 months ago
Dockerfile-alpine first commit 2 months ago
Dockerfile-nvenc first commit 2 months ago
LICENSE first commit 2 months ago first commit 2 months ago
docker-compose.yaml update 2 months ago first commit 2 months ago first commit 2 months ago
rtmp-adr.yaml update 2 months ago
rtmp-server.yaml Update 'rtmp-server.yaml' 2 months ago
test.yaml update 2 months ago


Docker image for video streaming server that supports RTMP, HLS, and DASH streams.

Docker Automated build Build Status


This Docker image can be used to create a video streaming server that supports RTMP, HLS, DASH out of the box. It also allows adaptive streaming and custom transcoding of video streams. All modules are built from source on Debian and Alpine Linux base images.


  • The backend is Nginx with nginx-rtmp-module.
  • FFmpeg for transcoding and adaptive streaming.
  • Default settings:
    • RTMP is ON
    • HLS is ON (adaptive, 5 variants)
    • DASH is ON
    • Other Nginx configuration files are also provided to allow for RTMP-only streams or no-FFmpeg transcoding.
  • Statistic page of RTMP streams at http://<server ip>:<server port>/stats.
  • Available web video players (based on video.js and hls.js) at /usr/local/nginx/html/players.

Current Image is built using:

  • Nginx 1.17.5 (compiled from source)
  • Nginx-rtmp-module 1.2.1 (compiled from source)
  • FFmpeg 4.2.1 (compiled from source)

This image was inspired by similar docker images from tiangolo and alfg. It has small build size, adds support for HTTP-based streams and adaptive streaming using FFmpeg.


To run the server

docker run -d -p 1935:1935 -p 8080:8080 alqutami/rtmp-hls

For Alpine-based Image use:

docker run -d -p 1935:1935 -p 8080:8080 alqutami/rtmp-hls:latest-alpine

To run with custom conf file:

docker run -d -p 1935:1935 -p 8080:8080 -v custom.conf:/etc/nginx/nginx.conf alqutami/rtmp-hls

where custom.conf is the new conf file for Nginx.

To stream to the server

  • Stream live RTMP content to:

    rtmp://<server ip>:1935/live/<stream_key>

    where <stream_key> is any stream key you specify.

  • Configure OBS to stream content:
    Go to Settings > Stream, choose the following settings:

    • Service: Custom Streaming Server.
    • Server: rtmp://<server ip>:1935/live.
    • Stream key: anything you want, however provided video players assume stream key is test

To view the stream

  • Using VLC:

    • Go to Media > Open Network Stream.
    • Enter the streaming URL: rtmp://<server ip>:1935/live/<stream-key> Replace <server ip> with the IP of where the server is running, and <stream-key> with the stream key you used when setting up the stream.
    • For HLS and DASH, the URLs are of the forms: http://<server ip>:8080/hls/<stream-key>.m3u8 and http://<server ip>:8080/dash/<stream-key>_src.mpd respectively.
    • Click Play.
  • Using provided web players:
    The provided demo players assume the stream-key is called test and the player is opened in localhost.

    • To play RTMP content (requires Flash): http://localhost:8080/players/rtmp.html
    • To play HLS content: http://localhost:8080/players/hls.html
    • To play HLS content using hls.js library: http://localhost:8080/players/hls_hlsjs.html
    • To play DASH content: http://localhost:8080/players/dash.html
    • To play RTMP and HLS contents on the same page: http://localhost:8080/players/rtmp_hls.html


    • These web players are hardcoded to play stream key "test" at localhost.
    • To change the stream source for these players. Download the html files and modify the src attribute in the video tag in the html file. You can then mount the modified files to the container as follows:
      docker run -d -p 1935:1935 -p 8080:8080 -v custom_players:/usr/local/nginx/html/players alqutami/rtmp-hls
      where custom_players is the directory holding the modified html files.

Released under MIT license.

More info