Jitsi troubleshooting
Find your symptom, get the cause and the fix. These are the problems we fix most often on real Jitsi servers, with the exact settings and commands.
Problems in a meeting
Camera, microphone, screen sharing and dropped calls, for participants and organizers.
Jitsi camera or microphone not working
The camera or microphone is not detected, is greyed out, has a red line through it, or the browser shows a permission or unsupported error.
Jitsi screen sharing not working
The Share your screen button is missing or greyed out, Jitsi shows "Screen sharing failed!", or other people see a black, frozen or missing screen.
Jitsi "You have been disconnected": causes and fixes
A disconnect or reload message appears when joining, during a meeting or in a reconnect loop.
Why does Jitsi end after 5 minutes?
An embedded Jitsi meeting closes or redirects after about five minutes, even though audio and video worked.
Jitsi authentication session expired: what to do
A meeting asks you to log in again while it is running, sometimes followed by a disconnect.
Jitsi picture-in-picture not working
The PiP button is missing, its window does not open, or switching tabs does not trigger it.
Why are long Jitsi chat messages cut off?
A pasted or edited chat message loses its ending before other people receive it.
Jitsi virtual background or blur is missing
A background or blur option available on the web is absent or does not work in another client.
Audio, video and bridge failures
Server-side causes when video or audio fails for some or all participants.
Jitsi works with 2 people but not with 3: how to fix it
Two-person calls work, but when a third person joins video goes black, freezes or people drop.
Why do two person Jitsi calls fail or have one-way audio?
Two person calls work on the same LAN but fail across networks, with only host candidates in about:webrtc; alternatively, other participants hear you but you hear nobody.
Why does JVB fail every conference join with dcsctp4j NoClassDefFoundError?
java.lang.NoClassDefFoundError: Could not initialize class org.jitsi.dcsctp4j.DcSctpOptions, followed by failed conference joins.
Why do JVB and Jicofo disconnect from Prosody after upgrading?
org.jivesoftware.smack.XMPPException$StreamErrorException: undefined-condition, with No stream features to proceed with in JVB and Jicofo logs.
After an upgrade
Breakage after the rootless Docker releases or an operating system upgrade.
Prosody "unable to find the configuration file" after a Jitsi Docker upgrade
prosodyctl prints 'Prosody was unable to find the configuration file: /etc/prosody//config/prosody.cfg.lua' after upgrading docker-jitsi-meet to stable-11146 or newer.
Why are custom-config.js and custom-interface_config.js ignored?
Changes in custom-config.js or custom-interface_config.js do not appear after upgrading to stable-11146, for example the custom home-page title disappears.
Prosody fails after upgrading Ubuntu 24.04 to 26.04
After do-release-upgrade to Ubuntu 26.04, Prosody will not start: Error expanding wildcard pattern in Include "conf.d/*.cfg.lua" - LuaFileSystem is not available.
Certificates and login
Let's Encrypt and token errors.
Jitsi Let's Encrypt certificate failed: how to diagnose it
HTTPS shows a certificate warning, the web container cannot obtain a certificate, or a previously working certificate has expired.
Why did Let's Encrypt renewal stop after upgrading Jitsi Docker?
web-1 | seteuid: Operation not permitted, repeated in the web container logs while renewal never runs.
Jitsi JWT authentication not working
A meeting token is rejected, a login prompt appears, guests behave unexpectedly or participant tokens receive moderator rights.
Recording and transcription
Jibri, Jigasi and speech-to-text failures.
Jitsi recording not working: Jibri errors and fixes
Recording fails to start, stops after a few seconds, produces a file with no audio, or the Record button does nothing.
Jitsi transcription or subtitles not working
Turning on subtitles shows service-unavailable, nothing is transcribed, or transcripts contain join events but no speech.
Why does Jigasi crash with pthread_create failed (EAGAIN)?
Failed to start thread "Unknown thread" - pthread_create failed (EAGAIN)
More
Jitsi Meet echo, feedback and double audio
Your voice comes back after a delay, incoming speech plays twice, or a loud ringing or howl starts when someone joins or unmutes.
Fix Jitsi Bluetooth headset sound and microphone problems
Your headset is connected, but Jitsi plays through laptop speakers, uses the wrong microphone, becomes silent after reconnecting or sounds worse when the microphone opens.
Why does the Jitsi whiteboard open but not sync?
Participants can open and draw on the whiteboard, but other participants do not receive their changes.
Jigasi or the transcriber rejects a private CA certificate
Jigasi or transcriber logs PKIX path building failed for a private HTTPS or WSS service even though the custom CA appears to have been imported.
Why is the Jitsi captions button grey or missing on mobile?
Start closed captions stays grey after the transcriber joins, never becomes Stop, and offers no language choice; Android may show no captions. [S1][S2]
Jitsi chat and poll controls do not respond to the keyboard
Keyboard-only users cannot reach a chat reaction or message menu, Escape does not cancel editing, or poll answer navigation does not work as expected.
Jitsi controls are skipped by Tab or do not activate
Tab skips a visible Admit all, visitor, breakout rename, calendar sign-in or dial-in control, or Enter and Space do not activate it.
Prosody cannot load auth_token after a Jitsi Docker update
After updating Docker Jitsi to stable-11248-1, Prosody cannot load auth_token and logs that the Lua inspect module is missing.
Why does Jitsi transcription disable live streaming or recording?
Transcription disables streaming or hides local recording; on 11248, Start can request server recording despite displaying Local recording. [S1][S2][S5]
Why do Vosk captions stop when several people speak in Jitsi?
SEVERE: VoskWebsocketStreamingSession.onMessage: Error parsing message:
Why are the last sentences missing from my Jitsi Whisper transcript?
The saved transcript misses the last sentences; Jigasi logs Websocket closed: 1006 and Skynet reports the connection was closed before sending all results. [S1]
Nothing matches. Try the site search with Ctrl K.
Can't find what you need?
Tell us which Jitsi problem or setup you want a guide for. We read every request.
Stuck, or would rather not do this by hand?
Deploy it in one click
A private Jitsi server in your own AWS account with SSL, your domain and optional recording, transcription and JWT. Free 15 minute trial.
Start free trialTalk to a Jitsi engineer
Setup, fixes, branding, recording, scaling. Tell us what is happening and we reply with a plan and a quote.
Get expert help