Docs / Common problems
When something won't connect.
This page separates real failures from wrong expectations. NodalDesk touches network,
capture, audio, input and system permissions; it helps to look at the symptom in parts.
The machine doesn't show up on the LAN
NodalDesk discovers hosts via UDP broadcast on port 19876. Check that host
and client are on the same network, that the host is running, and that the firewall
isn't blocking discovery or the host's port.
The browser won't open the session
The web client requires WebCodecs. Use an up-to-date Chrome, Edge or Opera. If the
browser doesn't support WebCodecs, the web client may load but not render video
correctly.
After a restart, Windows doesn't show up
To get in from the sign-in screen, turn on “Available from startup” in Settings. After a
restart the machine takes a little while to show up in your list again: give it a few
seconds before retrying.
Wake-on-LAN doesn't wake the PC
Check BIOS/UEFI, power saving, stored MAC and wired networking. From Android, the app
only tries to send WoL if the phone is on Wi-Fi. It's a local-network signal: from outside
you need another NodalDesk machine of yours already on in that same network to send the
packet for you.
Wayland shows extra icons or notices
KDE, GNOME and wlroots don't behave the same. Some capture indicators belong to the
system, not to NodalDesk. Not every visual notice can be removed from the app's UI.
Quality drops away from home
The relay or mobile route can have more latency and less bitrate headroom than a LAN.
Automatic quality lowers resolution or frame rate before letting the video fall behind,
and goes back up when the link can take it.
The PIN doesn't work
The technical PIN is 6 digits and rotates every 5 minutes by default. If you take too
long, read the QR again or request a new PIN from the host.
No screen with the monitor off
Without a monitor, some systems stop producing a picture. On Linux, KDE Wayland can create
a virtual screen; on other desktops, keep a screen connected (or a dummy HDMI plug).