{"id":13483309,"url":"https://github.com/coturn/coturn","last_synced_at":"2025-05-13T15:03:32.447Z","repository":{"id":35086510,"uuid":"39242894","full_name":"coturn/coturn","owner":"coturn","description":"coturn TURN server project","archived":false,"fork":false,"pushed_at":"2025-04-29T14:53:51.000Z","size":5235,"stargazers_count":12278,"open_issues_count":421,"forks_count":2108,"subscribers_count":324,"default_branch":"master","last_synced_at":"2025-05-05T22:41:57.539Z","etag":null,"topics":["networking","server","turn"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coturn.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-07-17T08:15:16.000Z","updated_at":"2025-05-05T21:21:44.000Z","dependencies_parsed_at":"2023-10-04T11:28:31.116Z","dependency_job_id":"cc8ab8b2-2165-4bd7-86d4-48cb418c3ce4","html_url":"https://github.com/coturn/coturn","commit_stats":{"total_commits":1388,"total_committers":138,"mean_commits":"10.057971014492754","dds":0.590057636887608,"last_synced_commit":"4ba2f69ba3382b7590b11932c8e7a6f723a303df"},"previous_names":[],"tags_count":123,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coturn%2Fcoturn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coturn%2Fcoturn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coturn%2Fcoturn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coturn%2Fcoturn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coturn","download_url":"https://codeload.github.com/coturn/coturn/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253968407,"owners_count":21992253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["networking","server","turn"],"created_at":"2024-07-31T17:01:09.943Z","updated_at":"2025-05-13T15:03:32.422Z","avatar_url":"https://github.com/coturn.png","language":"C","readme":"[![Docker CI](https://github.com/coturn/coturn/actions/workflows/docker.yml/badge.svg  \"Docker CI\")](https://github.com/coturn/coturn/actions/workflows/docker.yml)\n[![Docker Hub](https://img.shields.io/docker/pulls/coturn/coturn?label=Docker%20Hub%20pulls \"Docker Hub pulls\")](https://hub.docker.com/r/coturn/coturn)\n\n[Docker Hub](https://hub.docker.com/r/coturn/coturn)\n| [GitHub Container Registry](https://github.com/orgs/coturn/packages/container/package/coturn)\n| [Quay.io](https://quay.io/repository/coturn/coturn)\n\n# Coturn TURN server #\n\ncoturn is a free open source implementation of TURN and STUN Server.\nThe TURN Server is a VoIP media traffic NAT traversal server and gateway.\n\n## Installing / Getting started\n\nLinux distros may have a version of coturn which you can install by\n```\napt install coturn\nturnserver --log-file stdout\n```\n\nOr run coturn using docker container:\n```\ndocker run -d -p 3478:3478 -p 3478:3478/udp -p 5349:5349 -p 5349:5349/udp -p 49152-65535:49152-65535/udp coturn/coturn\n```\nSee more details about using docker container [Docker Readme](https://github.com/coturn/coturn/blob/master/docker/coturn/README.md)\n\n\n## Developing\n\n### Dependencies\n\ncoturn requires following dependencies to be installed first\n- libevent2\n\nOptional\n- openssl (to support TLS and DTLS, authorized STUN and TURN)\n- libmicrohttp and [prometheus-client-c](https://github.com/digitalocean/prometheus-client-c) (prometheus interface)\n- MariaDB/MySQL (user database)\n- [Hiredis](https://github.com/redis/hiredis) (user database, monitoring)\n- SQLite (user database)\n- PostgreSQL (user database)\n\n### Building\n```shell\ngit clone git@github.com:coturn/coturn.git\ncd coturn\n./configure\nmake\n```\n\n\n## Features\n\nSTUN specs:\n\n  * [RFC 3489](https://datatracker.ietf.org/doc/html/rfc3489) - \"classic\" STUN\n  * [RFC 5389](https://datatracker.ietf.org/doc/html/rfc5389) - base \"new\" STUN specs\n  * [RFC 5769](https://datatracker.ietf.org/doc/html/rfc5769) - test vectors for STUN protocol testing\n  * [RFC 5780](https://datatracker.ietf.org/doc/html/rfc5780) - NAT behavior discovery support\n  * [RFC 7443](https://datatracker.ietf.org/doc/html/rfc7443) - ALPN support for STUN \u0026 TURN\n  * [RFC 7635](https://datatracker.ietf.org/doc/html/rfc7635) - oAuth third-party TURN/STUN authorization\n  \nTURN specs:\n\n  * [RFC 5766](https://datatracker.ietf.org/doc/html/rfc5766) - base TURN specs\n  * [RFC 6062](https://datatracker.ietf.org/doc/html/rfc6062) - TCP relaying TURN extension\n  * [RFC 6156](https://datatracker.ietf.org/doc/html/rfc6156) - IPv6 extension for TURN\n  * [RFC 7443](https://datatracker.ietf.org/doc/html/rfc7443) - ALPN support for STUN \u0026 TURN\n  * [RFC 7635](https://datatracker.ietf.org/doc/html/rfc7635) - oAuth third-party TURN/STUN authorization\n  * DTLS support (http://tools.ietf.org/html/draft-petithuguenin-tram-turn-dtls-00)\n  * Mobile ICE (MICE) support (http://tools.ietf.org/html/draft-wing-tram-turn-mobility-02)\n  * TURN REST API (http://tools.ietf.org/html/draft-uberti-behave-turn-rest-00)\n  * Origin field in TURN (Multi-tenant TURN Server) (https://tools.ietf.org/html/draft-ietf-tram-stun-origin-06)\n  * TURN Bandwidth draft specs (http://tools.ietf.org/html/draft-thomson-tram-turn-bandwidth-01)\n  * TURN-bis (with dual allocation) draft specs (http://tools.ietf.org/html/draft-ietf-tram-turnbis-04)\n\nICE and related specs:\n\n  * [RFC 5245](https://datatracker.ietf.org/doc/html/rfc5245) - ICE\n  * [RFC 5768](https://datatracker.ietf.org/doc/html/rfc5768) – ICE–SIP\n  * [RFC 6336](https://datatracker.ietf.org/doc/html/rfc6336) – ICE–IANA Registry\n  * [RFC 6544](https://datatracker.ietf.org/doc/html/rfc6544) – ICE–TCP\n  * [RFC 5928](https://datatracker.ietf.org/doc/html/rfc5928) - TURN Resolution Mechanism\n\nThe implementation fully supports the following client-to-TURN-server protocols:\n\n  * UDP (per [RFC 5766](https://datatracker.ietf.org/doc/html/rfc5766))\n  * TCP (per [RFC 5766](https://datatracker.ietf.org/doc/html/rfc5766) and [RFC 6062](https://datatracker.ietf.org/doc/html/rfc6062))\n  * TLS (per [RFC 5766](https://datatracker.ietf.org/doc/html/rfc) and [RFC 6062](https://datatracker.ietf.org/doc/html/rfc6062)): including TLS1.3; ECDHE is supported.\n  * DTLS1.0 and DTLS1.2 (http://tools.ietf.org/html/draft-petithuguenin-tram-turn-dtls-00)\n  * SCTP (experimental implementation).\n\nRelay protocols:\n\n  * UDP (per [RFC 5766](https://datatracker.ietf.org/doc/html/rfc5766))\n  * TCP (per [RFC 6062](https://datatracker.ietf.org/doc/html/rfc6062))\n\nUser databases (for user repository, with passwords or keys, if authentication is required):\n\n  * SQLite\n  * MariaDB/MySQL\n  * PostgreSQL\n  * Redis\n  * MongoDB\n  \n  \nManagement interfaces:\n * telnet cli \n * HTTPS interface\n\n\nMonitoring:\n * Redis can be used for status and statistics storage and notification\n * [prometheus](https://prometheus.io/) interface (unavailable on apt package)\n\nMessage integrity digest algorithms:\n\n  * HMAC-SHA1, with MD5-hashed keys (as required by STUN and TURN standards)\n\nTURN authentication mechanisms:\n\n  * 'classic' long-term credentials mechanism;\n  * TURN REST API (a modification of the long-term mechanism, for time-limited secret-based authentication, for WebRTC applications: http://tools.ietf.org/html/draft-uberti-behave-turn-rest-00);\n  * experimental third-party oAuth-based client authorization option;\n\nPerformance and Load Balancing:\n\nWhen used as a part of an ICE solution, for VoIP connectivity, this TURN server can handle thousands simultaneous calls per CPU (when TURN protocol is used) or tens of thousands calls when only STUN protocol is used. For virtually unlimited scalability a load balancing scheme can be used. The load balancing can be implemented with the following tools (either one or a combination of them):\n\n  * DNS SRV based load balancing;\n  * built-in 300 ALTERNATE-SERVER mechanism (requires 300 response support by the TURN client);\n  * network load-balancer server.\n\nTraffic bandwidth limitation and congestion avoidance algorithms implemented.\n\nTarget platforms:\n\n  * Linux (Debian, Ubuntu, Mint, CentOS, Fedora, Redhat, Amazon Linux, Arch Linux, OpenSUSE)\n  * BSD (FreeBSD, NetBSD, OpenBSD, DragonFlyBSD)\n  * Solaris 11\n  * Mac OS X\n  * Cygwin (for non-production R\u0026D purposes)\n  * Windows (native with, e.g., MSVC toolchain)\n\nThis project can be successfully used on other `*NIX` platforms, too, but that is not officially supported.\n\nThe implementation is supposed to be simple, easy to install and configure. The project focuses on performance, scalability and simplicity. The aim is to provide an enterprise-grade TURN solution.\n\nTo achieve high performance and scalability, the TURN server is implemented with the following features:\n\n  * High-performance industrial-strength Network IO engine libevent2 is used\n  * Configurable multi-threading model implemented to allow full usage of available CPU resources (if OS allows multi-threading)\n  * Multiple listening and relay addresses can be configured\n  * Efficient memory model used\n  * The TURN project code can be used in a custom proprietary networking environment. In the TURN server code, an abstract networking API is used. Only couple files in the project have to be re-written to plug-in the TURN server into a proprietary environment. With this project, only implementation for standard UNIX Networking/IO API is provided, but the  user can implement any other environment. The TURN server code was originally developed for a high-performance proprietary corporate environment, then adopted for UNIX Networking API\n  * The TURN server works as a user space process, without imposing any special requirements on the system\n\n\n## Links\n\n- Project homepage: https://coturn.github.io/\n- Repository: https://github.com/coturn/coturn/\n- Issue tracker: https://github.com/coturn/coturn/issues\n- Google group: https://groups.google.com/forum/#!forum/turn-server-project-rfc5766-turn-server\n","funding_links":[],"categories":["C","Moderne Web-Anwendungsentwicklung","Communication and Collaboration Tools","Libraries","server","Server Software","Stun \u0026 Turn"],"sub_categories":["STUN/TURN","C/C++"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoturn%2Fcoturn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoturn%2Fcoturn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoturn%2Fcoturn/lists"}