Skip to main content

coTURN quick installation

What is a TURN Server?

A TURN server is a network entity in charge of relaying media in VoIP-related protocols. This includes SIP, H.323, WebRTC, and other protocols.

When you try reaching out directly from one browser to another with voice or video data (sometimes other arbitrary kinds of data), you end up going through different network devices. Some of these devices include Firewalls and NATs (Network Address Translators) which may decide due to internal policies not to pass your data.

When there are some network securities like a firewall, then the data packet does not transfer and we do not get proper streaming of another user.

So we use the TURN server for this solution.

Ant Media Server does not require a TURN server even if there is Symmetric NAT. However, it's required if UDP ports are blocked for any reason or Ant Media Server is used as a signaling server in P2P communication.

Install the TURN server

Automatic Installation

By running the script, you can quickly install and configure the TURN server automatically.

  • Get the script
wget && chmod +x
  • Run the installation script
sudo ./

Manual Installation

If you want to install the TURN server manually, please follow the below steps.

  1. Install coturn
apt-get update && apt-get install coturn
  1. Enable TURN server
  • Edit the below file.
vim /etc/default/coturn
  • Add the following line
  1. Configure the TURN server
  • Edit file: /etc/turnserver.conf by adding the following 2 lines as mentioned below:
  1. Once you are done with making the changes as suggested above, restart the TURN server with the below command.
systemctl restart coturn

Note: If you using an AWS EC2, GCP, or Azure instance, etc. where NAT is used, you must add the following lines in the turnserver.conf file.

  • EC2 private ip address : relay-ip=your_private_ip
  • EC2 Public/Private ip address : external-ip=your_public_ip/your_private_ip

Also, Open the following ports on the security group or firewall.

  • TCP 443 #TLS listening port
  • TCP 3478-3479 #coturn listening port
  • TCP 32355-65535 #relay ports range
  • UDP 3478-3479 #coturn listening port
  • UDP 32355-65535 #relay ports range

How to test Turn Server

You can test the TURN server if it is configured and working properly with the below methods.

  1. Command Line
turnutils_uclient -v -t -T -u username -w password -p 3478 turn_server_ip
  1. Web Browser

  • Once done. Click Gather Candidates. If the details you provided, are validated, you will get the output as in the below image.

How to use the TURN server with Ant Media

To use your TURN server with Ant Media, check out this Guide