-
Notifications
You must be signed in to change notification settings - Fork 618
Beginners Guide To Getting Started With Ant Media server
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.
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.
- Download latest Linux Ubuntu Desktop : https://ubuntu.com/download/desktop
- Download latest Linux Ubuntu Server : https://ubuntu.com/download/server
For Ubuntu Desktop Installation, the following guides might be useful for you:
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
- 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.
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
After that, if you type ls, you can see if the script was installed or not.
- 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.
You can check the service if it is running.
sudo service antmedia status
You can stop/start the service anytime you want.
sudo service antmedia stop
sudo service antmedia start
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
-
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
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
- Introduction
- Quick Start
- Installation
- Publishing Live Streams
- Playing Live Streams
- Conference Call
- Peer to Peer Call
- Adaptive Bitrate(Multi-Bitrate) Streaming
- Data Channel
- Video on Demand Streaming
- Simulcasting to Social Media Channels
- Clustering & Scaling
- Monitor Ant Media Servers with Apache Kafka and Grafana
- WebRTC SDKs
- Security
- Integration with your Project
- Advanced
- WebRTC Load Testing
- TURN Servers
- AWS Wavelength Deployment
- Multi-Tenancy Support
- Monitor Ant Media Server with Datadog
- Clustering in Alibaba
- Playlist
- Kubernetes
- Time based One Time Password
- Kubernetes Autoscaling
- Kubernetes Ingress
- How to Install Ant Media Server on EKS
- Release Tests
- Spaceport Volumetric Video
- WebRTC Viewers Info
- Webhook Authentication for Publishing Streams
- Recording Streams
- How to Update Ant Media Server with Cloudformation
- How to Install Ant Media Server on GKE
- Ant Media Server on Docker Swarm
- Developer Quick Start
- Recording HLS, MP4 and how to recover
- Re-streaming update
- Git Branching
- UML Diagrams