Web-svc-coturn Role

Description: No description available

Variables

  • author: Kevin Veen-Birkenbach

  • description: Deploys Coturn, a free and open-source TURN/STUN server

  • license: Infinito.Nexus NonCommercial License

  • license_url: https://s.infinito.nexus/license

  • company: Kevin Veen-Birkenbach

Consulting & Coaching Solutions https://www.veen.world

README

Coturn

This folder contains the role to deploy and manage a Coturn service.

Description

Coturn is a free and open-source TURN (Traversal Using Relays around NAT) and STUN (Session Traversal Utilities for NAT) server.
It enables real-time communication (RTC) applications such as WebRTC to work reliably across NATs and firewalls.
Without TURN/STUN, video calls, conferencing, and peer-to-peer connections often fail due to NAT traversal issues.
Coturn solves this by acting as a relay server and/or discovery service for public IP addresses.
More background:
* Wikipedia: Traversal Using Relays around NAT
* Wikipedia: Session Traversal Utilities for NAT
* Official Coturn Docs: https://github.com/coturn/coturn/wiki

Overview

This role deploys Coturn via Docker Compose using the sys-stk-semi-stateless stack.
It automatically configures: - TURN and STUN listening ports - Relay port ranges - TLS certificates (via Let’s Encrypt integration) - Long-term credentials and/or REST API secrets

Typical use cases: - Nextcloud Talk - Jitsi - BigBlueButton - Any WebRTC-based application

Features

  • Stateless container deployment (no database or persistent volume required)

  • Automatic TLS handling via sys-stk-front-base

  • TURN and STUN support over TCP and UDP

  • Configurable relay port ranges for scaling

  • Integration into Infinito.Nexus inventory/variable system

Further Resources