nazarpc/coturn repository overview

⁠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⁠