67 lines
1.8 KiB
Markdown
67 lines
1.8 KiB
Markdown
Setting up your own TURN server
|
|
===============================
|
|
|
|
Jami can be configured to use TURN or STUN servers ([RFC
|
|
5766](https://tools.ietf.org/html/rfc5766)) 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](https://github.com/coturn/coturn) server. There are other
|
|
TURN/STUN server implementations available under a free license, such
|
|
as [TurnServer](http://turnserver.sourceforge.net/) and
|
|
[Restund](http://www.creytiv.com/restund.html).
|
|
|
|
## Installing
|
|
|
|
COTURN is available in most Linux distributions. On Debian, install it
|
|
with the following command:
|
|
|
|
```bash
|
|
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).
|
|
|
|
```bash
|
|
turnadmin -a -u bob -p secretpassword -r sfl
|
|
```
|
|
|
|
## Launching the TURN server
|
|
|
|
```bash
|
|
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 |
|