Skip to main content

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.

Quick overview

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