mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-10-10 10:48:10 +02:00

Files

Kevin Veen-Birkenbach 73a38e0b2b Refactor TURN/STUN handling:

- Split internal/external Coturn for BBB and Nextcloud
- Added dedicated relay port ranges per app
- Updated env and compose overrides for coturn
- Ensure coturn role is loaded conditionally
- Standardize credential/env passing for coturn
@See https://chatgpt.com/share/68d6f376-4878-800f-b4f7-62822caa49ea

2025-09-26 22:11:55 +02:00

config

Refactor TURN/STUN handling:

2025-09-26 22:11:55 +02:00

README.md

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

Coturn Project — https://github.com/coturn/coturn
Coturn Wiki — https://github.com/coturn/coturn/wiki
TURN on Wikipedia — https://en.wikipedia.org/wiki/Traversal_Using_Relays_around_NAT
STUN on Wikipedia — https://en.wikipedia.org/wiki/STUN