Troubleshooting
Voice, screen share audio, rate limits, uploads, disconnects, startup and plugins.
Press F9 in a voice channel for connection diagnostics. Set debug=true in config.ini for verbose server logs. The desktop app keeps its own log file.
- You are on HTTPS or
http://localhost. See Why HTTPS. - Port
40000is open on both UDP and TCP, in the firewall and the router. - Behind NAT, Docker or a cloud provider,
webRtc.announcedAddressis set to the public IP or domain, and that domain is not behind a CDN proxy. - Server and clients on the same machine or LAN,
webRtc.announcedAddressis set to127.0.0.1(same machine) or the server's LAN IP (other devices). Most routers do not loop the public IP back to your own network. - Remote users connect but LAN users do not (or the other way around),
webRtc.announcedAddressis the public address andwebRtc.internalAnnouncedAddressis the server's LAN IP. See WebRTC. - IPv6 only clients cannot connect,
webRtc.announcedAddressV6is set and the port is open for IPv6 too.
Users are being counted as your proxy's IP. The server logs the address to trust. Usually a CDN like Cloudflare in front of your proxy. See Behind a Proxy.
Failing instantly with 413: your proxy caps body size. Nginx needs client_max_body_size 0. Error about size or quota: Sharkord's own storage limits.
- Windows: install the Visual C++ Redistributable (x64).
- Port in use: change
server.portor stop the other process. - Permissions: the data directory must be writable. In Docker, set
PUIDandPGID.
It is only read at startup. A file that fails validation is replaced by the defaults, with the reason in the log.
The reason is in the plugin's Logs tab. Usual causes:
- Plugins are off in the server settings.
- The folder name does not match the manifest
id. manifest.json,server/index.jsorclient/index.jsis missing.- No
onLoadexport. sdkVersiondoes not match the server.onLoadoronUpgradethrew or took over 30 seconds.
Screen Share Audio
What gets shared depends on where you stream from:
| Streaming from | Audio shared |
|---|---|
| Firefox | None |
| Chromium based browsers | A tab's audio. Whole system audio only on some systems, and never for a single window |
| Desktop app | Everything playing on the computer except Sharkord itself |
Stream from the desktop app for games and other apps. On Linux it needs PipeWire.
- Share system audio is on in the screen share options.
- In a browser, share a tab or the entire screen, not a window. See the table above.
- Linux with EasyEffects or another virtual output: turn on Desktop Settings → Screen share → Capture audio from all outputs. Apps that play through a virtual output are skipped otherwise.
- Restrict Own Audio is on, in the screen share options or under User Settings → Devices.
- The streamer wears headphones or mutes their mic. A mic picking up the speakers sends viewers back through the voice channel, not the stream.
- Windows: audio software that replays every app's sound from its own process (SteelSeries Sonar, Voicemeeter, Nahimic and similar) defeats Restrict Own Audio. Close it while streaming.
- Linux with EasyEffects: turn on Capture audio from all outputs, as above. Otherwise the stream records EasyEffects' output, which carries the call's voices too.
EasyEffects with Process all input/output streams used to reroute the stream's audio capture. Update the desktop app.
Expected. The desktop app shares everything except Sharkord, since there is no reliable way to tell which sound belongs to which window. Mute what viewers should not hear.
Still stuck? Search the issues or ask in discussions.