Skip to content

Beginners Guide To Getting Started With Ant Media server

Murat Ugur Eminoglu edited this page May 17, 2022 · 4 revisions

Attention: We have migrated our documentation to our new platform, Ant Media Resources. Please follow this link for the latest and up-to-date documentation.

This document is specially designed for people who are not familiar with Linux and basic terminal commands.

1. Download the Operating System

Ant Media Server runs on Linux(Ubuntu) and macOS. it supports only x64 architecture.

Ubuntu 18.04 is officially supported and auxiliary scripts are provided for Ubuntu 20.04 and CentOS 8.

In addition, It's known that Ant Media Server is used on SUSE, Debian, RHLE distributions as well.

For Ubuntu Desktop Installation, the following guides might be useful for you:

2. Download Ant Media Server

There are three ways to download/access Ant Media Server

  • Community Edition (free) can be downloaded from Releases
  • Enterprise Edition can be downloaded on your account after you get a license from antmedia.io
  • To get a 14-day free trial please check here

3. Open Terminal and Go to the zip file Directory

  • After you have downloaded the Ant Media Server (AMS) zip file to your computer/server, you need to open the terminal and go to the directory where you have downloaded the Ant Media Server installation Zip file.

To see currently in which directory you are in

pwd

To see view a list of the files and folders in a given directory on your computer (also for seeing the correct naming)

ls

e.g., if your computer downloaded the AMS zip file into the “Downloads” section, then you need to go to the Downloads directory.

According to which directory you downloaded your ant media server .zip file (i.e., Downloads), please write: cd + space + the directory you downloaded your ant media file

cd Downloads

It means you’re in the “Downloads” directory. After that, if you write ls in your terminal, you can see the exact ant media server zip file name on your screen.

4. Download Installation Script

To download the install_ant-media-server.sh script installation shell script, simply copy-paste the below command

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

image

After that, if you type ls, you can see if the script was installed or not.

5. Run the Installation Script

  • Fresh Installation

For a clean new installation:

sudo ./install_ant-media-server.sh -i [ANT_MEDIA_SERVER_INSTALLATION_FILE]
  • To Update over Older Version

You need to add "-r true" at the end of the command line if you want to keep your settings from previous installation.

sudo ./install_ant-media-server.sh -i [ANT_MEDIA_SERVER_INSTALLATION_FILE] -r true

Note: [ANT_MEDIA_SERVER_INSTALLATION_FILE] must be the exact name of the AMS zip file.

  • e.g., Ant-media-server-enterprise-2.4.1-20211124_1803.zip

  • Once installation script is run, the installation automatically starts.

6. Control the Service

You can check the service if it is running.

sudo service antmedia status

status

You can stop/start the service anytime you want.

sudo service antmedia stop
sudo service antmedia start

7. Install SSL for your Ant Media Server

Please make sure that your server instance has 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

To enable SSL, please run the command

sudo ./enable_ssl.sh -d {DOMAIN_NAME}

Please don't forget to replace {DOMAIN_NAME} with your domain name. e.g., abc.shopping.com

For detailed information about SSL, follow SSL Setup

8. Accessing Ant Media Server Web Panel

  • Open your browser and type the server URL https://Domain_Name:5443 to go to the web panel.

  • If SSL is not enabled, the web panel can be accessed through http://Server_IP_Address:5080

  • If you're having difficulty in accessing the web panel, there maybe some firewall that blocks accessing the port 5080/5443 image

How to Uninstall AMS

sudo rm -rf /usr/local/antmedia/
sudo kill -9…(... for the process’s code)
sudo userdel antmedia
sudo rm /etc/systemd/system/antmedia.service
sudo systemctl daemon-reload
sudo systemctl reset-failed

Also, you can check if Ant Media Server is completely removed from the system

/usr/local/antmedia

User Guide

Reference

Troubleshooting

Draft

Proposals

Clone this wiki locally