troubleshooting
Every Roomler documentation page tagged “troubleshooting”.
Verify your install
Confirm the Roomler agent is running, enrolled, reachable and on the mesh — and verify the artifact you installed was really signed by us.
Get startedPer-OS permissions
What Windows, macOS and Linux each require before screen capture and input injection work — and why a missing grant usually produces silence, not an error.
Remote desktopHow devices connect
The connection cascade — LAN, direct internet, NAT hole-punching, then relays — how Roomler picks a path, and how to see which one a pair is using.
Private networkTroubleshooting
Start here when something is not working — a device is offline, a session will not connect, a screen is black, or a call has no video.
TroubleshootingDevice is offline or stale
A machine that was there and is not — what online, stale and offline actually mean, and the causes in the order they usually occur.
TroubleshootingCannot connect, or the session is slow
Diagnose a session that will not start or feels sluggish — starting with the single most common cause, a VPN client that captured the local network.
TroubleshootingBlack screen or wallpaper only
The session connects and shows nothing — almost always a capture permission or a display-session problem, and almost never a network one.
TroubleshootingCalls have no video
Everyone joins the call and nobody appears — the media path, why signalling can look perfect while no packets flow, and what to check first.
TroubleshootingInstall problems
The installer fails, antivirus blocks it, or the machine never appears afterwards — per-OS causes and the fixes that actually work.
TroubleshootingCollecting diagnostics
What to gather before asking for help — status, peers, logs and a paired diagnostic bundle — and what to redact before you share it.
Troubleshooting