Pick the right package

Get the desktop package for your distribution from Downloads. On Debian and Ubuntu, use the .deb: install it with your package manager and open NodalDesk from the applications menu (on Ubuntu 23.10 and later it is the only way, because the system does not let an AppImage turn on its security sandbox). With the AppImage (Arch, Fedora and others; it needs FUSE 2, libfuse2), make it executable and open it; the app itself can add it to your menu.

If your system asks for screen capture or control permissions, grant them to share the screen and use it from your other devices.

Start the host

Once installed, start NodalDesk on the Linux computer you want to control. When you sign in with your account, that machine is linked to it and shows up in your devices. The host sets up video, audio, input and clipboard, and can also show a QR and a PIN as an extra step to validate or add a machine.

nodaldesk

That PIN is 6 digits and rotates periodically. Once a client is linked, that device's credentials are persisted, so you shouldn't have to repeat that step every session.

Connect from another device

From Android, sign in with your account and you'll see your machines; if you want to validate one with an extra step, you can scan the QR and enter the PIN. From the web, sign in at app.nodaldesk.com from a browser with WebCodecs. From desktop, use the NodalDesk app for Linux or Windows.

On the local network, NodalDesk uses UDP discovery on port 19876. Away from home, it relies on relay to reach your machines.

Adjust the connection in the app

In Nodes, select the device to manage sharing and permissions. During a connection, use the viewer's quality selector to adjust it. Internet connections use the relay configured by the application.

The nodaldesk command opens the installed desktop application. Development CLI options do not configure this application; use its own controls.