I’m writing these notes up, mainly as a reference for me in the future – but they might just help others looking to do similar.

Issue:

During the Coronavirus season, our church, like many, ventured into the world of streaming services, primarily to YouTube but with an eye to multiplexing to both YouTube and Facebook at the same time.

Initially, the plan was to stream from OBS Studio to an intermediate platform, restream.io

We tested with OBS sending the stream to restream and for the first week, everything worked fine.
Then, the second week about 10 minutes before due to go live restream.io suffered an outage. Fortunately, we were quickly able to flip to sending our stream directly to YouTube and our broadcast worked successfully.
However, for me, an issue with a shared service leaves a sour taste and so began the journey to discover what would be involved in running our own RTMP server.

It turns out the solution has been relatively straightforward…

Our solution:

Firstly, we signed up for a new VPS with vultr.com
We opted for a 1 x vCPU, 2GB RAM, High-Frequency machine with 64GB SSD storage, and 2TB monthly bandwidth. Research suggested that RTMP streaming/multiplexing is not particularly CPU/RAM intensive and is more about bandwidth consumption.

Once the VPS was provisioned, we selected the Ubuntu 18.04 LTS install image. The machine was duly created and connected via SSH to its IP shown in the portal.

Basic Installation:

Update all packages:

root@hostname#    sudo apt-get update
root@hostname#   sudo apt-get upgrade

Then install NGINX:

sudo apt-get install nginx
sudo apt install libnginx-mod-rtmp

At this point you can test that NGINX has been installed correctly by testing with your browser:

http://<your-servers-IP-address>

If successful, you should see the NGINX default page:

Configuration for YouTube

Now, on to adding the RTMP config.

Edit the nginx.conf file as follows:

nano /etc/nginx/nginx.conf

Add a section at the bottom of the file as follows:

rtmp {
     server {
             listen 1935;
             chunk_size 4096;

             application live { 
                        live on; 
                        record off; 
                        # Edit and enable line below to push incoming stream to YouTube 
                        # push rtmp://x.rtmp.youtube.com/live2/<your-Stream-Key-Copied-From-YouTube>; 
             }
      }
}

If you aren’t familiar with YouTube Live stream settings the key can be obtained from the following screens:

Save the nginx.conf file (Ctrl +X ) and start the NGINX service

root@hostname# systemctl restart nginx

Best practice would suggest installing a firewall package on your VPS to minimise its exposure to the Internet.

For Ubuntu 18.04, UFW is perfectly acceptable and well documented. Vultr have a comprehensive document at https://www.vultr.com/docs/configure-ubuntu-firewall-ufw-on-ubuntu-18-04

For me, I created 4 simple rules permitting inbound SSH from my home ISP’s fixed IP, and a friend’s IP plus equivalent rules permitting inbound TCP1935 from each of our addresses.

We chose to use OBS to create the stream footage, therefore we had to fill in the stream details within OBS Stream settings:

If you then click on Start Streaming within OBS, your OBS content should start appearing within your YouTube Studio account (albeit with a 30second delay).

Facebook Live

Facebook made some changes a little while back to only accepts RTMPS streams which NGINX and the RTMP can’t natively support. So, another jigsaw piece needs to be added to the puzzle. Enter stunnel!

Edit your nginx.conf file to include a new push statement.

push rtmp://127.0.0.1:1936/rtmp/<Facebook-persistent-stream-key>

restart nginx

systemctl restart nginx

Install Stunnel

apt-get install stunnel4 -y

Edit the stunnel boot configuration as follows (change ENABLE from 0 to 1)

nano /etc/default/stunnel4
ENABLE=1

Edit the stunnel config as follows:

nano /etc/stunnel/stunnel.conf
pid = /var/run/stunnel4/stunnel.pid
output = /var/log/stunnel4/stunnel.log

setuid = stunnel4
setgid = stunnel4

# https://www.stunnel.org/faq.html
socket = r:TCP_NODELAY=1
socket = l:TCP_NODELAY=1

debug = 4

[fb-live]
client = yes
accept = 1936
connect = live-api-s.facebook.com:443
verifyChain = no

Enable Stunnel and start it

systemctl enable stunnel4.service
systemctl restart stunnel4.service

Categories: Tech

6 Comments

littlerichardgground · 3rd May 2020 at 18:29

Thanks for the simple, and step-by-step instructions, you wont believe the crap I’ve gone through trying to set this up. I’m actually streaming to Youtube, Facebook, and a JWPlayer embedded on our website. My issues were with custom build Nginx and RTMP modules. If anyone is reading and having all kinds of issues, Install as noted here, this is the mainline build, and you’ll be good as gold. Thanks, you are a God send.

    anthony · 10th May 2020 at 07:31

    Hi Richard. Thanks for taking the time to comment. I’m glad the write-up helped you. Anthony

Ajay Kumar · 26th March 2021 at 12:06

Awesome Tutorial. Very helpful

    anthony · 26th March 2021 at 16:23

    My pleasure. Glad you found it useful.

allankg · 26th February 2022 at 17:36

Hello, by chance I’ve found that for it to work you need to change the stunnel address like :
accept = 1936 —> accept = 127.0.0.1:1936
Maybe it was localhost by default on previous versions, but using stunnel4 version 3:5.60+dfsg-1 I had to do it.

Cheers and thanks for the handy tutorial.

    Anthony · 7th March 2022 at 19:54

    Thanks for the feedback and taking the time to comment. I’ll certainly bear that in mind if I have to rebuild the machine at any point.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.