Support

Most answers are in the guides. If you're stuck, open an issue or send an email.

Common Questions

“Couldn't Connect”

Nothing answered at that address. Check that the VNC server is running on the remote computer, the port is right, a firewall isn't blocking it, and the computer is awake. macOS and Windows use port 5900. The Linux setup script's first desktop is 5901.

From another network, check that your VPN or Tailscale is connected. A rejected password shows a different message and never retries on its own.

The Computer Rejected the Password

NomadVNC asks for a new password and does not retry the old one. Standard VNC only uses the first 8 characters.

On a Mac, set the VNC password under Screen Sharing, then Computer Settings. In NomadVNC, enter your Mac account's short name under Add macOS Username.

How Do I Right-Click or Scroll on a Phone?

Two-finger tap to right-click, two-finger drag to scroll, and pinch to zoom. Choose Touch or Trackpad under Display. The full list is in the app under Display, then Gestures.

Switching away from the app keeps the session. If the phone suspended it, NomadVNC reconnects when you come back.

Do I Need an Account, a VPN, or Tailscale?

No. On your local network, choose Local Mode, type the computer's address, and connect.

To reach a computer on another network, use any VPN that can reach its VNC port, or choose Sign in with Tailscale. That Tailscale runs inside NomadVNC, only carries NomadVNC traffic, and is separate from the Tailscale app. An account is only for syncing saved computers between devices and sharing them by email.

Do I Need NomadVNC Host?

No. NomadVNC connects to any VNC server. NomadVNC Host is an optional Windows download that shares a PC's screen, including the sign-in screen, and starts at boot. It is a separate file on the release page and updates separately from the viewer.

macOS or Windows Warns on First Launch

The builds are not code-signed yet. On Windows, choose More info, then Run anyway. On macOS, follow the steps in the install guide.

Is NomadVNC on the App Store or Play Store?

Not yet. On Android, install the APK from GitHub Releases. On iPhone and iPad, build the app from source with the native setup guide.

The Sign-In Email Didn't Arrive

Check your spam folder. Sign-in emails come from [email protected] and expire after 15 minutes.

How Do I Delete My Account?

On a computer, open the Account tab, expand Delete Account, choose Delete Account…, and confirm. On a phone, open Settings, go to Account, tap Delete Account…, and confirm. Without the app, request deletion by email.

Contact

Bugs and Ideas

Report a bug or request a feature on GitHub Issues.

Email

Questions about your account or this site: [email protected].

Security

Please don't post security issues publicly. See SECURITY.md.