Setting up your own TURN server

Jami can be configured to use TURN or STUN servers (RFC 5766) to establish a connection between two peers.

The default TURN server is “turn.jami.net”, with username “ring”, password “ring”, and realm “ring”.

In this guide, we will setup a coturn server. There are other TURN/STUN server implementations available under a free license, such as TurnServer and Restund.

Installing

COTURN is available in most Linux distributions. On Debian, install it with the following command:

apt-get install coturn

Configuring

Here is a basic turnserver.conf file:

listening-port=10000
listening-ip=0.0.0.0
min-port=10000
max-port=30000
lt-cred-mech
realm=sfl

This also will function as a STUN server. The STUN server does not require a username and password (STUN uses very little bandwidth).

Creating users on your TURN server

To create users on your TURN server, use the turnadmin binary (this might require superuser permissions).

turnadmin -a -u bob -p secretpassword -r sfl

Launching the TURN server

turnserver -c turnserver.conf

Configuring Jami to authenticate with the TURN server

You can configure Jami to use your TURN server from the advanced section of your account settings:

Field

Value

Example

server url

host and port of your server

0.0.0.0:10000

username

username

bob

password

password

secretpassword

realm

realm

sfl