Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Camera and microphone are refused | Page served over HTTP. | Switch to HTTPS (or test on localhost). |
| Connected, but no sound or video from others | UDP ports closed, or wrong announced address. | Open RTC_MIN_PORT-RTC_MAX_PORT over UDP; set ANNOUNCED_IP. |
| Works at home but not at work | UDP blocked by the network. | Set up a TURN server, ideally turns: on port 443 or 5349. |
| “Connecting” never completes | The proxy does not forward WebSocket. | Forward Upgrade and Connection on /socket.io/. |
| Chat: “Unreadable message” | Link without the #k= key, or with another key. |
Share the full link copied from the room. |
| Nothing in the iframe | Missing allow attribute. |
Add allow="camera; microphone; display-capture; autoplay". |
Logs: make logs. Server status: curl http://localhost:3000/health.