nginx-rtmp

Docker image and helm chart for streaming to rtmp using Nginx.

• Main repo
• GitHub Mirror
• GitLab Mirror

Contents

• Docker
• Helm Chart

Docker

The official nginx docker image built on Alpine uses the Nginx repository for the nginx* packages, which doesn't include most modules. Since this image specifically makes use of the rtmp module, I've opted to use the upstream alpine repos with the prebuilt stable nginx and rtmp module.

The docker image uses a precreated configuration file with two include statements: one inside of an http{} block and one in an rtmp{} block. Configuration files for each should be placed in /etc/nginx/conf.d/ and /etc/nginx/rtmp.d/, respectively.

The image exposes the standard HTTP and RTMP ports: 80 and 1935.

Helm Chart

The helm chart generates an RTMP configuration file for the Docker image using the values provided in values.yaml.

Options will include:

• Multiple endpoints, each with one or more of the following configured:
  • Raw RTMP
  • HLS
  • Twitch
  • In the future, the following may be added:
    • YouTube
    • Others?

TODO:

• Helm:
  • Options related to recording
  • Options related to playing existing files
  • Options related to pushing to other servers (e.g. Twitch)