Coturn

Coturn TURN server as Docker image

How to use

sudo docker run \
  -d \
  -p 3478:3478 \
  -p 3478:3478/udp \
  -p 65435-65535:65435-65535/udp \
  --restart=always \
  --name coturn \
  nazarpc/coturn

Environment variables

This image supports some environment variables:

• ANONYMOUS: When set to 1, will accept anonymous requests and will not use username and password
• USERNAME: Username needed for turn. Defaults to username
• PASSWORD: Password needed for turn. Defaults ro password
• REALM: Realm needed for turn. Defaults to realm
• LISTEN_PORT: Defaults to 3478
• TLS_LISTEN_PORT: Defaults to 5349
• MIN_PORT: This defines the min-port for the range used by turn. Defaults to 65435
• MAX_PORT: This defines the max-port for the range used by turn. Defaults to 65535

An example:

# This makes sure, that the min- and max-port is the same for all environment variables
export MIN_PORT=50000
export MAX_PORT=50010
docker run \
  -d \
  -p 3478:3478 \
  -p 3478:3478/udp \
  -p ${MIN_PORT}-${MAX_PORT}:${MIN_PORT}-${MAX_PORT}/udp \
  -e USERNAME=another_user \
  -e PASSWORD=another_password \
  -e REALM=another_realm \
  -e MIN_PORT=${MIN_PORT} \
  -e MAX_PORT=${MAX_PORT} \
  --restart=always \
  --name coturn \
  nazarpc/coturn

Certificates

Store the cert under /opt/cert.pem and the key under /opt/pkey.pem and mount them as volumes:

sudo docker run \
  -d \
  -p 3478:3478 \
  -p 3478:3478/udp \
  -p 65435-65535:65435-65535/udp \
  -v /opt/cert.pem:/etc/ssl/turn_server_cert.pem \
  -v /opt/pkey.pem:/etc/ssl/turn_server_pkey.pem \
  --restart=always \
  --name coturn \
  nazarpc/coturn

Acknowledgments

Initially images was created by Anastasia Zolochevska: https://github.com/anastasiia-zolochevska/turn-server-docker-image

Then it was improved by Dennis Boldt: https://github.com/boldt/turn-server-docker-image

Contribution

Feel free to create issues and send pull requests (for big changes create an issue first and link it from the PR), they are highly appreciated!

License

Free Public License 1.0.0 / Zero Clause BSD License

https://opensource.org/licenses/FPL-1.0.0

https://tldrlegal.com/license/bsd-0-clause-license