The following describes the steps in setting up a new EC2 instance. We recommend running Red5 Pro on Ubuntu Linux.
These instructions cover how to install Red5 Pro as single server. To install an autoscale cluster, refer to the AWS Autoscale Installation Instructions.
Prerequisite information is available on the Technical Prerequisites page.
Create your VPC, Subnet and Security Group:
VPC, Subnet, and Security Group Creation
- In the AWS Console, Select EC2 Dashboard
- Click Launch Instance to create a new EC2 instance
- Select the latest Ubuntu 20.04 LTS Server (x86) from the AMI quickstart list (Note: we suggest that you choose ubuntu over the Amazon Linux AMI because the latter does not support all of the libraries needed for some Red5 Pro functionality).
Continue through the setup options with most of the default settings, and these specifics:
- Instance Type: The t2.medium VM type will be able to support minimal testing - however, because they do not have dedicated CPUs, you may see issues. The c5.xlarge (suggested both for number of CPUs and network performance) will support most live production streaming implementations.
- In choosing the instance type, note that
WebRTCuses more memory and CPU than
RTMPstreaming and that higher the resolution, bitrate and framerate of your streams, they more load they will incur on your server.
- Security Group: Create a new security group with the following Inbound ports open:
|5080||default web access of Red5 Pro; Websockets for WebRTC||TCP|
|443||modified https access of Red5 Pro; secure websockets for WebRTC||TCP|
|1935||default Red5 Pro RTMP port||TCP|
|8554||default RTSP port||TCP|
|40000-65535||TURN/STUN/ICE port range||UDP|
Once the EC2 instance is setup and available, you can now SSH into it and continue the installation of required software.
In following along with the next several steps, please replace occurances of
firstname.lastname@example.org with the .pem file you defined on instance setup and the Public DNS value for your instance, respectively. Also note, your ssh login credentials may be ec2-user intead of ubuntu if you set up an alternate *nix flavor image
To install the Red5 Pro Server:
- Download the server .zip distribution to your local machine. Make sure to login with your account on https://account.red5pro.com and download the server from https://account.red5pro.com/download.
SFTP the server .zip distribution into the /tmp directory of your server:
sftp -i yourpemkey.pem email@example.com sftp> put red5pro-server-xxx-release.zip /tmp/ quit
SSH into the instance using the AWS credentials:
ssh -i yourpemkey.pem firstname.lastname@example.org
Follow directions for installing Red5 Pro server on linux