BigBlueButton error codes
Wed, 13 May 2026 - BigBlueButtonBigBlueButton sometimes show an error with a 4-digit number but no further explanation. I could not find a complete list online, so I dug into the sources (1, 2) and collected all error codes I could find:
1101 - 1121: Client errors¶
Connection or media decoding issues detected by the client, but not necessarily caused by the client.
| Code | Name | Description |
|---|---|---|
| 1101 | SIGNALLING_TRANSPORT_DISCONNECTED | Websocket connection interrupted or connection closed by the server. |
| 1102 | SIGNALLING_TRANSPORT_CONNECTION_FAILED | Websocket failed to connect. |
| 1104 | SCREENSHARE_PLAY_FAILED | Unable to decode video stream, usually caused by old browsers or missing video codecs. |
| 1105 | PEER_NEGOTIATION_FAILED | WebRTC failed to establish a direct connection. UDP traffic is likely blocked by a firewall or NAT. If you have a TURN server and still get this error, then a firewall is also blocking TURN traffic. |
| 1107 | ICE_STATE_FAILED | WebRTC connection closed or failed, and restarting ICE peer negotiation also failed. |
| 1110 | ENDED_WHILE_STARTING | Old connection replaced by new one. This is usually ignored by clients. |
| 1120 | MEDIA_TIMEOUT | Mediaserver not responding, which is usually a server-side issue. |
| 1121 | UNKNOWN_ERROR | Unhandled or unknown errors. |
1130 - 1138: GetDisplayMedia Errors¶
Issues while querying or accessing browser media sources. Those are usually caused by the browser or operating system blocking access to media sources, or by broken devices or device drivers that do not provide any compatible media formats.
| Code | Name | Description |
|---|---|---|
| 1130 | GetDisplayMediaGenericError | Unhandled or unknown errors. |
| 1131 | AbortError | Operation aborted, likely by the user. |
| 1132 | InvalidStateError | Media source is already being used exclusively by another application. |
| 1133 | OverconstrainedError | Media source does not support any of the requested resolutions or framerates. |
| 1134 | TypeError | Browser is too old or does not implement required browser features. |
| 1135 | NotFoundError | No media sources found, or blocked by the operating system. |
| 1136 | NotAllowedError | Access to media source denied by the browser or the user. |
| 1137 | NotSupportedError | Browser is too old or does not implement required browser features. |
| 1138 | NotReadableError | Media source found, but does not respond. Broken cable? |
1301 - 1310: SFU CLient Errors¶
Connection issues betwen client and media server (SFU). Those are usually reported as 11xx client-side errors (see above).
| Code | Name | Description |
|---|---|---|
| 1301 | WEBSOCKET_DISCONNECTED | See 1101 |
| 1302 | WEBSOCKET_CONNECTION_FAILED | See 1102 |
| 1305 | PEER_NEGOTIATION_FAILED | See 1105 |
| 1307 | ICE_STATE_FAILED | See 1107 |
| 1310 | ENDED_WHILE_STARTING | See 1110 |
2000 - 2300: SFU Server Errors¶
Error codes returned by the media server (via SFU). Those are not necessary server-side errors, but errors detected and reported by the media server or SFU. Most are not reported to the user, but masked behind fatal errors.
| Code | Name | Description |
|---|---|---|
| 2000 | MEDIA_SERVER_CONNECTION_ERROR | SFU fails to connect to media server. |
| 2001 | MEDIA_SERVER_OFFLINE | Media server offline or crashed. |
| 2002 | MEDIA_SERVER_NO_RESOURCES | Media server at maximum capacity. |
| 2003 | MEDIA_SERVER_REQUEST_TIMEOUT | Media server overloaded or crashing. |
| 2004 | MEDIA_SERVER_GENERIC_ERROR | Media server is broken and the SFU has no ideas what's happening. |
| 2020 | ICE_ADD_CANDIDATE_FAILED | Invalid or blacklisted WebRTC connection candidate. |
| 2021 | ICE_GATHERING_FAILED | No usable WebRTC connection candidates found. |
| 2022 | ICE_STATE_FAILED | WebRTC connection failed to establish. |
| 2200 | MEDIA_GENERIC_ERROR | Unhandled error related to media processing. |
| 2201 | MEDIA_NOT_FOUND | Client requested a media stream that does not exist. |
| 2202 | MEDIA_INVALID_SDP | Client provided invalid SDP (Session Description Protocol). |
| 2203 | MEDIA_NO_AVAILABLE_CODEC | Client does not support any of the media codecs offered by the media server. |
| 2208 | MEDIA_GENERIC_PROCESS_ERROR | Media processing (e.g. video transcoding) failed, likely caused by a client sending invalid data. |
| 2209 | MEDIA_ADAPTER_OBJECT_NOT_FOUND | Internal media processing pipeline error. |
| 2210 | MEDIA_CONNECT_ERROR | Internal media processing pipeline error. |
| 2211 | MEDIA_NOT_FLOWING | Media pipeline stalled, likely caused by connection or bandwith issues. |
| 2300 | SFU_INVALID_REQUEST | Client sends an invalid request to the SFU, which is likely a bug in BBB or a version mismatch between client and server components. |