Skip to content

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.