# pion/turn

Pion TURN, an API for building TURN clients and servers

Repository: https://github.com/pion/turn
Canonical: https://ross.abutalabs.com/products/turn
Language: Go
License: MIT
License Family: permissive
Topics: go, turn, webrtc, pion, golang, turn-servers, turn-server, stun, nat, traversal, turn-client
Last push: 2026-08-20T00:47:44+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 3056, "days_push": 14, "days_rel": 18, "gap_med": 11.5, "n_releases_24m": 21}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2248, forks 369 (observed 2026-08-28T04:06:30.240200+00:00)

## What it is
Pion TURN is a Go library providing an API for building TURN (Traversal Using Relays around NAT) clients and servers, part of the Pion WebRTC ecosystem. It is designed to be embedded in applications rather than deployed as a standalone configured binary.

## Use cases
- build a TURN server for WebRTC media relay
- embed NAT traversal relay in my Go application
- implement a TURN client in Go
- help WebRTC connections through restrictive NATs
- customize TURN allocation behavior programmatically
- self-host a STUN/TURN relay for video calls

## When to choose
- you need TURN/STUN functionality embedded in a Go application
- you want programmatic control over allocations and relay state
- you need a portable, cross-platform relay without config files
- you are building RTC infrastructure and want an extendable API

## When to avoid
- you just want a ready-made TURN server binary with config files
- your stack is not Go and you cannot embed a Go library
- you need a full production media server rather than relay primitives

## Facets
- artifact type: library
- maturity: active
- function: networking, http-server, middleware
- domain: networking, web-development
- platform: go, cross-platform, windows
- tags: turn, stun, webrtc, nat-traversal, relay, ice, pion, real-time, linux, macos

## Member repositories
- pion/turn (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:30.240200+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:43:57.240151+00:00, confidence not recorded.
  - readme: https://github.com/pion/turn (fetched 2026-08-28T04:06:30.240200+00:00, sha 1c19d4d77569)
- Data as of 2026-08-30T08:39:29.467469+00:00.
