From caa909eed61877f94b6bd16bbf6b8a0ee6d88a3c Mon Sep 17 00:00:00 2001 From: thigg Date: Thu, 26 Mar 2026 21:30:41 +0100 Subject: [PATCH] Add reverse proxy configuration for Matrix RTC Added configuration instructions for reverse proxy with nginx for LiveKit Server. --- docs/configuring-playbook-matrix-rtc.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/configuring-playbook-matrix-rtc.md b/docs/configuring-playbook-matrix-rtc.md index 9360202ad..92184d5f2 100644 --- a/docs/configuring-playbook-matrix-rtc.md +++ b/docs/configuring-playbook-matrix-rtc.md @@ -38,6 +38,29 @@ 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; + } +``` + ## Installing After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records) and [adjusting firewall rules](#adjusting-firewall-rules), run the playbook with [playbook tags](playbook-tags.md) as below: