Docker image for TURN server
A Docker container with the Coturn TURN server.
- hub.docker.com (Docker image): zenosmosis/docker-coturn
- github.com (Repo): zenOSmosis/docker-coturn
Run the container
docker run \
-d \
-p 3478:3478 \
-p 3478:3478/udp \
-p 65435-65535:65435-65535/udp \
--restart=always \
--name coturn \
zenosmosis/docker-coturnEnvironment variables
This image supports some environment variables:
USERNAME: Username needed for turn. Defaults tousernamePASSWORD: Password needed for turn. Defaults ropasswordREALM: Realm needed for turn. Defaults torealmMIN_PORT: This defines the min-port for the range used by turn. Defaults to65435MAX_PORT: This defines the max-port for the range used by turn. Defaults to65535
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 \
zenosmosis/docker-coturnAn easier example (if Docker Compose is installed)
docker-compose up(see docker-compose.yml for configuration)
Certificates
Store the cert under /opt/cert.pem and the key under /opt/pkey.pem and mount them as volumes:
docker run \
-d \
-p 3478:3478 \
-p 3478:3478/udp \
-p 65435-65535:65435-65535/udp \
--volume /opt/cert.pem:/etc/ssl/turn_server_cert.pem \
--volume /opt/pkey.pem:/etc/ssl/turn_server_pkey.pem \
--restart=always \
--name coturn \
zenosmosis/docker-coturnDebugging
docker logs coturn
docker exec -it coturn /bin/bashBonus: Build and push the container to Docker Hub
# Clone
git clone https://github.com/zenOSmosis/docker-coturn.git
# Build
docker build -t zenosmosis/docker-coturn .
# Tag
VERSION=0.0.2
docker tag zenosmosis/docker-coturn zenosmosis/docker-coturn:$VERSION
# Login to Docker (if not already logged in)
docker login
# Push
docker push zenosmosis/docker-coturn:latest
docker push zenosmosis/docker-coturn:$VERSION
# At this point, you MAY want to log out of Docker, as it could cause authentication errors when trying to build other's containers
docker logoutThanks
The initial version of this image was created by anastasiia-zolochevska/turn-server-docker-image. Thanks to boldt/turn-server-docker-image for the README.md and Dockerfile updates.

Formed in 2009, the Archive Team (not to be confused with the archive.org Archive-It Team) is a rogue archivist collective dedicated to saving copies of rapidly dying or deleted websites for the sake of history and digital heritage. The group is 100% composed of volunteers and interested parties, and has expanded into a large amount of related projects for saving online and digital history.
