From cc3a8a1d40798555f36206864c0be2598e44d5f5 Mon Sep 17 00:00:00 2001
From: stratself <stratself@example.com>
Date: Sat, 21 Feb 2026 02:58:12 +0000
Subject: [PATCH] docs: move Livekit's inbuilt TURN guide to top

The purpose is to simplify new deployments, which are more likely
to use Livekit-only calls. This also makes docs flow a bit better
---
 docs/calls/livekit.mdx | 47 +++++++++++++++++++++---------------------
 1 file changed, 24 insertions(+), 23 deletions(-)

diff --git a/docs/calls/livekit.mdx b/docs/calls/livekit.mdx
index 118970b60..574b31d9b 100644
--- a/docs/calls/livekit.mdx
+++ b/docs/calls/livekit.mdx
@@ -175,7 +175,30 @@ Start up the services using your usual method - for example `docker compose up -
 
 ## Additional Configuration
 
-### TURN Integration
+### Using LiveKit's built in TURN server
+
+Livekit includes a built in TURN server which can be used in place of an external option. This TURN server will only work with Livekit, so you can't use it for legacy Matrix calling or anything else.
+
+If you don't want to set up a separate TURN server, you can enable this with the following changes:
+
+```yaml
+### add this to livekit.yaml ###
+turn:
+  enabled: true
+  udp_port: 3478
+  relay_range_start: 50300
+  relay_range_end: 50400
+  domain: livekit.example.com
+```
+
+```yaml
+### Add these to docker-compose ###
+ports:
+  - "3478:3478/udp"
+  - "50300-50400:50300-50400/udp"
+```
+
+### Integration with an external TURN server
 
 If you've already set up coturn, there may be a port clash between the two services. To fix this, make sure the `min-port` and `max-port` for coturn so it doesn't overlap with LiveKit's range:
 
@@ -208,28 +231,6 @@ rtc:
       secret: "COTURN_SECRET"
 ```
 
-## LiveKit's built in TURN server
-
-Livekit includes a built in TURN server which can be used in place of an external option. This TURN server will only work with Livekit, so you can't use it for legacy Matrix calling - or anything else.
-
-If you don't want to set up a separate TURN server, you can enable this with the following changes:
-
-```yaml
-### add this to livekit.yaml ###
-turn:
-  enabled: true
-  udp_port: 3478
-  relay_range_start: 50300
-  relay_range_end: 50400
-  domain: livekit.example.com
-```
-
-```yaml
-### Add these to docker-compose ###
-- "3478:3478/udp"
-- "50300-50400:50300-50400/udp"
-```
-
 ### Related Documentation
 
 For testing, use the [LiveKit Connection Tester](https://livekit.io/connection-test) with the token returned by `/sfu/get` or `/get_token`