Common error messages
BigBlueButton shows a four-digit error code when something goes wrong. Here are the most common ones and how to fix them.
Most issues = firewall ports or browser permissions. Start there before digging deeper.
1001 - WebSocket disconnected
Symptom: Connection was working, then dropped suddenly.
Most likely cause: Internet connection lost or server restart.
Solution: Refresh the page, check your internet.
1002 - Could not make WebSocket connection
Symptom: You can't connect to the meeting at all.
Most likely cause: Firewall blocks WebSocket traffic (ws:// / wss://).
Solution: Ask IT to allow ports 80 and 443. Details under Connection not possible.
1003 - Browser not supported
Symptom: Your browser is too old.
Solution: Update Chrome, Firefox, Edge, or Safari to the latest version.
1004 - Call failed
Symptom: Microphone test failed.
Most likely cause: Network or browser permission issue.
Solution: Check microphone permissions in the browser, check firewall. Details under No sound or image.
1007 - ICE negotiation failed
Symptom: Audio/video won't connect.
Most likely cause: Firewall blocks UDP ports 16384-32768.
Solution: Open UDP ports. Details under Connection not possible.
1010 - ICE negotiation timeout
Symptom: Connection takes too long and times out.
Most likely cause: Slow network or strict firewall.
Solution: Use a wired connection instead of Wi-Fi, close other bandwidth-hungry apps.
1020 - Media cloud connection failed
Symptom: Streaming servers unreachable.
Solution: Check your connection, go through everything in Connection not possible.
When nothing helps
- Clear browser cache (
Ctrl + Shift + R) - Try a different browser
- Try a different internet connection (mobile hotspot as a test)
- Contact our support with the exact error code - Contact support