Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
1 result

docker-nginx-rtmp

  • Clone with SSH
  • Clone with HTTPS
  • Andrej Ramašeuski's avatar
    2903081c
    History

    docker-nginx-rtmp

    A Dockerfile installing NGINX, nginx-rtmp-module and FFmpeg from source with default settings for HLS live streaming. Built on Alpine Linux.

    • Nginx 1.18.0 (Stable version compiled from source)
    • nginx-rtmp-module 1.2.1 (compiled from source)
    • ffmpeg 4.3.1 (compiled from source)
    • Default HLS settings (See: nginx.conf)

    Docker Stars Docker Pulls Docker Automated build Build Status

    Usage

    Server

    • Pull docker image and run:
    docker pull alfg/nginx-rtmp
    docker run -it -p 1935:1935 -p 8080:80 --rm alfg/nginx-rtmp

    or

    • Build and run container from source:
    docker build -t nginx-rtmp .
    docker run -it -p 1935:1935 -p 8080:80 --rm nginx-rtmp
    • Stream live content to:
    rtmp://<server ip>:1935/stream/$STREAM_NAME

    SSL

    To enable SSL, see nginx.conf and uncomment the lines:

    listen 443 ssl;
    ssl_certificate     /opt/certs/example.com.crt;
    ssl_certificate_key /opt/certs/example.com.key;

    This will enable HTTPS using a self-signed certificate supplied in /certs. If you wish to use HTTPS, it is highly recommended to obtain your own certificates and update the ssl_certificate and ssl_certificate_key paths.

    I recommend using Certbot from Let's Encrypt.

    Environment Variables

    This Docker image uses envsubst for environment variable substitution. You can define additional environment variables in nginx.conf as ${var} and pass them in your docker-compose file or docker command.

    Custom nginx.conf

    If you wish to use your own nginx.conf, mount it as a volume in your docker-compose or docker command as nginx.conf.template:

    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf.template

    OBS Configuration

    • Stream Type: Custom Streaming Server
    • URL: rtmp://localhost:1935/stream
    • Stream Key: hello

    Watch Stream

    • In Safari, VLC or any HLS player, open:
    http://<server ip>:8080/live/$STREAM_NAME.m3u8
    • Example Playlist: http://localhost:8080/live/hello.m3u8
    • VideoJS Player
    • FFplay: ffplay -fflags nobuffer rtmp://localhost:1935/stream/hello

    FFmpeg Build

    $ ffmpeg -buildconf
    
    ffmpeg version 4.3.1 Copyright (c) 2000-2020 the FFmpeg developers
      built with gcc 9.3.0 (Alpine 9.3.0)
      configuration: --prefix=/usr/local --enable-version3 --enable-gpl --enable-nonfree --enable-small --enable-libmp3lame --enable-libx264 --enable-libx265 --enable-libvpx --enable-libtheora --enable-libvorbis --enable-libopus --enable-libfdk-aac --enable-libass --enable-libwebp --enable-postproc --enable-avresample --enable-libfreetype --enable-openssl --disable-debug --disable-doc --disable-ffplay --extra-libs='-lpthread -lm'
      libavutil      56. 51.100 / 56. 51.100
      libavcodec     58. 91.100 / 58. 91.100
      libavformat    58. 45.100 / 58. 45.100
      libavdevice    58. 10.100 / 58. 10.100
      libavfilter     7. 85.100 /  7. 85.100
      libavresample   4.  0.  0 /  4.  0.  0
      libswscale      5.  7.100 /  5.  7.100
      libswresample   3.  7.100 /  3.  7.100
      libpostproc    55.  7.100 / 55.  7.100
    
      configuration:
        --prefix=/usr/local
        --enable-version3
        --enable-gpl
        --enable-nonfree
        --enable-small
        --enable-libmp3lame
        --enable-libx264
        --enable-libx265
        --enable-libvpx
        --enable-libtheora
        --enable-libvorbis
        --enable-libopus
        --enable-libfdk-aac
        --enable-libass
        --enable-libwebp
        --enable-postproc
        --enable-avresample
        --enable-libfreetype
        --enable-openssl
        --disable-debug
        --disable-doc
        --disable-ffplay
        --extra-libs='-lpthread -lm'

    Resources