Skip to main content

Installation

This quick start guide lets you set up Ant Media Server (AMS) Enterprise and try ultra-low latency streaming in a few minutes of time. The installation procedure for Ant Media Server Community and Enterprise Editions are same so you can install The Community Edition by following these instructions as well.

There are 2 options to start Ant Media Server (AMS).

  1. Install to a remote server with a public IP address
  2. Launch in AWSAzureDigitalOcean or another service provider.

In this document we'll show you the first option.

1. Download Ant Media Server

You can download Community Edition from Releases or download Enterprise Edition on your account on antmedia.io after you get a license on antmedia.io. After you download AMS, you will have a compressed file that contains the Ant Media Server.

2. Install Ant Media Server

Open a terminal and go to the directory where you download the Ant Media Server.

cd /path/to/where/ant-media-server/is/downloaded

Get the install_ant-media-server.sh script.

wget https://raw.githubusercontent.com/ant-media/Scripts/master/install_ant-media-server.sh 
chmod 755 install_ant-media-server.sh

Install Ant Media Server(AMS) as follows. Please don't forget to replace [ANT_MEDIA_SERVER_INSTALLATION_FILE] below with the downloaded .zip file name at step 1.

sudo ./install_ant-media-server.sh -i [ANT_MEDIA_SERVER_DOWNLOADED_FILE] 

3. Install SSL for Ant Media Server

Please make sure that your server instance has a public IP address and a domain is assigned to its public IP address. Then go to the folder where Ant Media Server is installed. Default directory is /usr/local/antmedia

cd /usr/local/antmedia

Run ./enable_ssl.sh script in AMS installation directory. Please don't forget to replace {DOMAIN_NAME} with your domain name.

sudo ./enable_ssl.sh -d {DOMAIN_NAME}

For detailed information about SSL, follow SSL Setup.

4. Ultra-low latency publishing/playing

Ant Media Server Enterprise Edition provides 0.5 seconds end-to-end latency. So let's try ultra-low latency first.

Publishing

  • Visit the page https://your-domain-address.com:5443/WebRTCAppEE/
  • Let the browser access the camera and mic. Then click Start Publishing
  • After you press the button, "Publishing" blinking text should appear

Playing

  • Visit the page https://your-domain-address.com:5443/WebRTCAppEE/player.html
  • Write the stream id in the text box( stream1 by default)
  • Press Start Play button. After you press the button, the WebRTC stream starts playing.
Note:
Don't forget that the stream id on the publish and play pages should be the same.

This quick start lets your try ultra-low latency streaming in Ant Media Server. If you have any problems, don't be hesitate to contact us.