From 6dda717ad88616e2218cb80362555b278f76a982 Mon Sep 17 00:00:00 2001
From: Max Ronzhin <m.ronzhin@ssphera.ru>
Date: Sat, 25 Jul 2026 22:31:02 +0300
Subject: [PATCH] env.example: warn LIVEKIT_PUBLIC_URL must be wss:// in HTTPS
 prod
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The client receives this value as the LiveKit serverUrl (via join.livekit_url).
A ws:// value on an https page is blocked as mixed content, so conferences
never connect — the exact failure hit on vidconf.ru, where the runtime value
had fallen back to the ws://localhost:7880 default. Spell out the prod
requirement (wss://<domain>/livekit/) next to the placeholder.
---
 .env.example | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.env.example b/.env.example
index 7b6d84e..2bfd50a 100644
--- a/.env.example
+++ b/.env.example
@@ -31,7 +31,13 @@ AUTH_COOKIE_SECURE=false
 LIVEKIT_API_KEY=devkey
 LIVEKIT_API_SECRET=change-me-livekit-secret
 LIVEKIT_URL=ws://localhost:7880
-# URL, который получает браузер клиента для подключения к LiveKit SFU.
+# URL, который получает браузер клиента для подключения к LiveKit SFU
+# (backend отдаёт его в join.livekit_url, фронт использует как serverUrl).
+# ⚠️ КРИТИЧНО для прода на HTTPS: значение ДОЛЖНО быть `wss://<домен>/livekit/`
+# (проксируется nginx на livekit:7880). Любой `ws://…` на https-странице =
+# mixed-content → браузер режет соединение, конференция не стартует (Safari/
+# Yandex жёстче). `ws://localhost:7880` тут — dev-плейсхолдер; в реальном .env
+# для vidconf.ru: LIVEKIT_PUBLIC_URL=wss://vidconf.ru/livekit/
 LIVEKIT_PUBLIC_URL=ws://localhost:7880
 
 # --- Coturn (dev placeholders) ---