conduit/TURN.md

# Setting up TURN/STURN

## General instructions

* This was tested against Conduit(Next), Coturn (Archlinux) and Element (Android)
* Build your own Conduit from source (always recommended). It's dead simple to build.
* Use the NEXT branch as only this branch provides the necessary functionality.
* This documentation assumes you have a [Coturn server](https://github.com/coturn/coturn) up and runnig. See [here](https://github.com/matrix-org/synapse/blob/develop/docs/turn-howto.md) how to get it working with the reference implementation. It's almost the same with Conduit.

## Edit/Add a few settings to your existing conduit.toml

```
# Settings to inform the clients where to find a TURN server
# to enable Audio/Video calls

# domain.tdl should match the REALM setting of coturn
# Adjust this as needed, If you have only one transport write it this way:
# turn_uris = ["turn:domain.tld?transport=tcp"]
turn_uris = ["turn:domain.tdl?transport=udp", "turn:domain.tld?transport=tcp"]

# the value of static-auth-secret of your turnserver
turn_secret = ""

# the default of one day
turn_ttl = 86400

# If you have your TURN server configured to use a username and password
# you can provide these information too. In this case comment out turn_secret above!
#turn_username = ""
#turn_password = ""
```

## Apply setting

Restart Conduit and enjoy audio and/or video call functionality.