From cdb45139503e2ffd017d6ee8676367b11f8b489f Mon Sep 17 00:00:00 2001 From: thigg Date: Fri, 27 Mar 2026 11:41:28 +0000 Subject: [PATCH] Moved documentation to nginx examples --- docs/configuring-playbook-matrix-rtc.md | 23 ++-------------------- examples/reverse-proxies/nginx/matrix.conf | 21 ++++++++++++++++++++ 2 files changed, 23 insertions(+), 21 deletions(-) diff --git a/docs/configuring-playbook-matrix-rtc.md b/docs/configuring-playbook-matrix-rtc.md index 92184d5f2..692d679f2 100644 --- a/docs/configuring-playbook-matrix-rtc.md +++ b/docs/configuring-playbook-matrix-rtc.md @@ -39,27 +39,8 @@ matrix_rtc_enabled: true In addition to the HTTP/HTTPS ports (which you've already exposed as per the [prerequisites](prerequisites.md) document), you'll also need to open ports required by [LiveKit Server](configuring-playbook-livekit-server.md) as described in its own [Adjusting firewall rules](configuring-playbook-livekit-server.md#adjusting-firewall-rules) section. ### Behind a reverse proxy -If you are behind an additional reverse proxy like nginx you also need to adjust it for livekit: -```yaml - location /livekit-server/ { - proxy_pass http://localhost:81/livekit-server/; - proxy_http_version 1.1; - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection "upgrade"; - proxy_set_header X-Forwarded-For $remote_addr; - proxy_set_header X-Forwarded-Proto $scheme; - proxy_set_header Host $host; - proxy_set_header X-Real-IP $remote_addr; - - # Long timeouts for persistent WebSocket connections - proxy_read_timeout 86400s; - proxy_send_timeout 86400s; - proxy_buffering off; - - access_log /var/log/nginx/matrix.access.log; - error_log /var/log/nginx/matrix.error.log; - } -``` +If you are behind an additional reverse proxy like nginx it needs to forward websockets for livekit. + ## Installing diff --git a/examples/reverse-proxies/nginx/matrix.conf b/examples/reverse-proxies/nginx/matrix.conf index 69b32eb6f..09f2c0fef 100644 --- a/examples/reverse-proxies/nginx/matrix.conf +++ b/examples/reverse-proxies/nginx/matrix.conf @@ -21,6 +21,27 @@ server { # if you don't use those, you can remove them # if you use e.g. Etherpad on etherpad.example.com, add etherpad.example.com to the server_name list server_name example.com matrix.example.com element.example.com; + + # needed for matrix rtc + location /livekit-server/ { + proxy_pass http://localhost:81/livekit-server/; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + + # Long timeouts for persistent WebSocket connections + proxy_read_timeout 86400s; + proxy_send_timeout 86400s; + proxy_buffering off; + + access_log /var/log/nginx/matrix.access.log; + error_log /var/log/nginx/matrix.error.log; + } + location / { # note: do not add a path (even a single /) after the port in `proxy_pass`,