Skip to main content

Installing AMS on Linux

Ant Media can be installed on Linux, specifically Ubuntu (18.04, 20.04, 22.04, and 24.04), CentOS (8 and 9), Rocky Linux (8 and 9), and Alma Linux (8 and 9). It is compatible with both the x86-64 and Arm64 architectures.

To run AMS on a single instance, you'll need at least 4 vCPU dedicated compute optimized servers with 8 GB of RAM. In terms of smooth read-write performance, SSD disks are highly recommended.

This document describes how to install both the Community Edition and the Enterprise Edition. There are several installation methods available, including deployment to a full VM, Docker, or Kubernetes.

Note: When manually installing AMS, this procedure can be used for both on-premises and cloud instances.

Download and Install Ant Media Server

You can install Ant Media Server Enterprise or Community Edition on your server using the following two methods.

  • Automatic Download and Install Ant Media Server (AMS)
  • Manually Download Ant Media Server (AMS)

Automatic Download and Install Ant Media Server (AMS)

You can easily perform these actions with just a single command using the latest version installation script.

Download the installation script

wget -O && sudo chmod 755

Install the Enterprise Edition

Add your license key as a parameter, which you received via email, to the installation file using the -l parameter, and then execute it. If you have a valid license key, the installation process will begin.

sudo ./ -l 'your-license-key'

Install the Community Editon

You can simply run the script without any parameters to automatically download and install the latest version of the Community Edition.

sudo ./

Manually Download Ant Media Server (AMS)

Download and save the latest AMS Community Edition or Enterprise Edition package.

  • Community Edition can be downloaded from Github Releases page.
  • Enterprise Edition can be downloaded from your account after you get a license on

If you downloaded the zip file locally on your system, you can use the general scp command to copy the file from your system to your AMS instance if it is running in the Cloud or in any Data Centre.

This command works on all Linux, Windows and Mac OS.

In case, you are using an SSH key:

scp -i ssh-key AMS-zip-file username@Ip-address:/home/username

In case you are using password for SSH:

scp AMS-zip-file username@Ip-address:/home/username

After you've downloaded or copied the file to the AMS instance, open a terminal and navigate to the directory where you downloaded/copied the AMS zip file.

cd path/to/where/

Download the installation script

Download the shell script.

sudo wget && sudo chmod 755

Update the installation script

If you have an existing installation script and we recommend updating it to the latest version, you can use the -u option with the script. This will update your current installation script to the newest version available.

sudo ./ -u

Run the installation script


For more command line options, type sudo ./ -h

Check if the service is running

You can check the service by using service command.

sudo service antmedia status

You can also start/stop the AMS service.

sudo service antmedia stop
sudo service antmedia start

Install SSL on AMS

Before proceeding, ensure that your AMS instance has a static public IP address and a domain is assigned to that public IP address. Also, ensure that TCP port 80 on the firewall/security groups is enabled, as this is required for the public SSL certificate.

Then, go to the folder where AMS is installed. Default directory is /usr/local/antmedia

cd /usr/local/antmedia

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

sudo ./ -d {DOMAIN_NAME}

For detailed information about SSL, follow SSL Setup.

Accessing the web panel

Once your AMS is installed, open your browser and navigate to the web panel by typing http://SERVER IP ADDRESS:5080. If you're having trouble accessing the web panel, it's possible that a firewall is blocking access to the 5080 port.

If an SSL certificate is installed, the server can be reached at http://domain-name:5443

Docker installation

Please visit for more information Docker and Docker Compose.

Cluster installation

Cluster installation is an advanced topic and it has its own page. Please visit Clustering & Scaling.

Server ports

In order to server run properly you need to open some network ports, defined below:

  • TCP: 80 (SSL)
  • TCP: 5080 (HTTP)
  • TCP: 5443 (HTTPS)
  • UDP: 4200 (SRT)
  • TCP : 1935 (RTMP)
  • UDP: 50000-60000 (WebRTC. The default range is 50000-60000 in v2.4.3 & above. Before 2.4.3, the default value was 5000-65000. Note that you can change port range in all releases.
  • TCP: 5000 (You need to open this port in only cluster mode for the internal network communication. It should not be open to the public)

Forward default http (80), https (443) ports to 5080 and 5443

Generally, port forwarding is used to forward default ports to the server's ports for convenience. For example, let's forward all incoming data from 80 to 5080.

sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 5080
sudo iptables -t nat -A PREROUTING -p tcp --dport 443 -j REDIRECT --to-port 5443

After running the command above, HTTP requests going to 80 will be forwarded to 5080. The HTTP requests going to 443 will be forwarded to 5443.

Please pay attention that once you enable SSL, port 80 should not be used by any processes, or should not be forwarded to any other port.

Listing and deleting current port forwardings

To list port forwarding run the command below.

sudo iptables -t nat --line-numbers -L

To delete a port forwarding run the command below.


Make port forwarding persistent

If you want the server to reload port forwarding after reboot, we need to install iptables-persistent package and save rules like below.

sudo apt-get install iptables-persistent

The command above will install iptables-persistent package. After installation, run the command below every time you make a change and want it to be persistent.

sudo sh -c "iptables-save >` /etc/iptables/rules.v4"

Please watch the quick installation of Ant Media Server.