yahboom
HomeTutorialsProduct
Solution
Blog
Online Store
About Us
EN/中文
Store
Jetson Orin NANO Developer Kit📖
01.Get started
  • 01. Learning route
  • 02. Get started quickly
  • 03. System Update Notes
  • 04. Disabling automatic updates and troubleshooting issues
  • 05. Jetson Orin Nano official kit screwdriver instructions
02.Jetson basic course
  • 01.Jetson board introduction
  • 02.Write Jetson original system
  • 03.Installing Jetson environment
  • 04.Backup SSD system
  • 05.Restore initial image system
  • 06.Upgrade to SUPER version (Optional)
  • 07.Write SUPER boot (Must read)
  • 08.SSD expansion
  • 09.Jetpack old system upgraded to Yahboom SUPER factory system
  • 10.Write the system onto your own SSD
03.Basic setting course
  • 01.Basic knowledge
  • 02.Network configuration
  • 03.SSH remote login
  • 04.VNC remote control
  • 05.RDP remote control
  • 06.Remote file transfer
  • 07.Jtop tool
  • 08.Exchange space expansion
  • 09.Use VSCode
  • 10.Use VMware
  • 11.Modify screen resolution
04.GPIO control course
  • 01.GPIO description
  • 02.GPIO library installation
  • 03.GPIO reading
  • 04.GPIO output
  • 05.Serial communication
  • 06.I2C communication
05.Vision basic course
  • 01.CSI camera preview
  • 02.USB camera preview
  • 03.Use Jupyter Lab
  • 04.Use JetCam
06.OpenCV basic course
  • 01.Image reading
  • 02.Image saving
  • 03.Image modification
  • 04.Image scaling
  • 05.Image cropping
  • 06.Image translation
  • 07.Image mirroring
  • 08.Image grayscale conversion
  • 09.Image binarization
  • 10.Image edge detection
  • 11.Add line segments
  • 12.Add rectangles
  • 13.Add circular shape
  • 14.Add ellipses
  • 15.Add polygons
  • 16.Add Text
  • 17.Preview USB camera image
  • 18.Preview CSI camera image
07.Vision advanced course
01.Environment construction
  • 01.TensorFlow
  • 02.PyTorch
  • 03.Torchvision
02.DeepStream development
  • 01.DeepStream environment
  • 02.License plate detection and recognition
  • 03.Parallel multi-model inference
  • 04.Object embedding vector generation
  • 05.Pose recognition
  • 06.NV optical flow anomaly detection
  • 07.Single-view 3D tracking
  • 08.Multi-view 3D tracking
03.NVIDIA TAO toolkit application
  • 01.Traffic scene object detection
  • 02.Person object detection
  • 03.Vehicle brand classification
  • 04.Vehicle model classification
  • 05.License plate detection and recognition
  • 06.Person semantic segmentation
  • 07.Retail product detection and recognition
  • 08.Person feature extraction and matching (ReID)
  • 09.Person action and pose classification
  • 10.Transformer-based person detection
  • 11.3D human skeleton detection
  • 12.LiDAR 3D point cloud detection
04.YOLO11 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
05.Mediapipe development
  • 01.Mediapipe environment
  • 02.Hand detection
  • 03.Face detection
  • 04.Face effects
  • 05.3D object recognition
  • 06.Virtual brush
  • 07.Gesture recognition
  • 08.Finger control
  • 09.Posture estimation
  • 10.Face mask
  • 11.Overall detection
  • 12.Green scene removal(Human)
06.YOLO26 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
07.QR code recognition
  • QR code recognition
08.Docker basic course
  • 01.Docker introduction
  • 02.Docker installation
  • 03.Docker command
  • 04.Docker usage
  • 05.Docker interaction
09.ROS2-Jazzy
01.ROS2 basic course
  • 1.Introduction to ROS2
  • 2.ROS2 install Jazzy
  • 3.ROS2 development environment
  • 4.ROS2 workspace
  • 5.ROS2 function package
  • 6.ROS2 node
  • 7.ROS2 topic communication
  • 8.ROS2 service communication
  • 9.ROS2 action communication
  • 10.ROS2 custom interface message
  • 11.ROS2 parameter service case
  • 12.ROS2 meta-function package
  • 13.ROS2 distributed communication
  • 14.ROS2 DDS
  • 15.ROS2 time related API
  • 16.ROS2 common command tools
  • 17.ROS2 rviz2 use
  • 18.ROS2 rqt toolbox
  • 19.ROS2 Launch startup file configuration
  • 20.ROS2 recording and playback tool
  • 21.ROS2 URDF model
  • 22.ROS2 Gazebo simulation platform
  • 23.ROS2 TF2 coordinate transformation
02.ROS2 vision course
  • 01.Camera preview (USB)
  • 02.Camera preview (CSI)
  • 03.Camera calibration (USB)
  • 04.Camera calibration (CSI)
  • 05.AR vision (USB)
  • 06.AR vision (CSI)
10.Large model basic course
01.Offline large model
  • 01.AI large model environment deployment
  • 02.Install large model dialogue platform
  • 03.Meta AI - Llama model
  • 04.Alibaba Cloud - Qwen model
  • 05.Microsoft - Phi-4-mini model
  • 06.DeepSeek - DeepSeek model
  • 07.Alibaba Cloud - Qwen-VL visual multimodal large model
  • 08.Google - Gemma visual multimodal large model
  • 9.Llava visual multimodal large model
  • 10.MiniCPM-V visual multimodal large model
  • 11.High-quality vision-language grounding (LocateAnything)
02.Online large model
  • 01.Tongyi Qianwen large model
  • 02.OpenRouter large model API aggregation platform
11.Large model application practice
01.Voice interaction application
  • 1.Voice interaction hardware connection (Must read)
  • 2.Offline speech to text (ASR)
  • 3.Offline text to speech (TTS)
  • 4.AI large model voice interaction
  • 5.AI large model offline voice assistant
02.Multimodal large model application (Online_Offline large model + Text_Voice interaction)
  • 01.Multimodal visual understand application
  • 02.Multimodal text image application
  • 03.Multimodal video analysis application
  • 04.Multi module visual position application
  • 05.Multimodal table scanning application
  • 06.Multimodal autonomous agent application
12.NVIDIA Isaac ROS course
  • 01.Build Isaac ROS environment
  • 02.Deep segmentation
  • 03.DNN stereoscopic depth
  • 04.Free space segmentation
  • 05.Image distortion processing
  • 06.Image segmentation
  • 07.3D scene reconstruction and mapping
  • 08.Object detection
  • 09.3D attitude estimation
  • 10.Visual SLAM
13.OpenClaw deployment and basic usage
01.OpenClaw deployment and introduction
  • 01.Quick start with the pre-configured environment (Recommended)
  • 02.OpenClaw Deployment
  • 03.OpenClaw WhatsApp Plugin Application
  • 04.OpenClaw WebChat Interaction
  • 05.OpenClaw TUI Interaction
  • 06.OpenClaw Tools Introduction
  • 07.OpenClawGate Gateway User Manual
  • 08.OpenClaw Features Overview
  • 09.OpenClawHub Introduction (Skill Installation)
02.OpenClaw basic application
  • 01.OpenClaw Application - File Management
  • 02.OpenClaw Application - Camera
  • 03.OpenClaw Application - Browser Control
  • 04.OpenClaw Application - Script Execution
  • 05.OpenClaw Application - AI Programming (Peripheral & GPIO Control)
  • 06.OpenClaw Application - Dedicated AI Assistant
  • 07.OpenClaw Web Search Capability Configuration
03.NVIDIA official Agent Skills application
  • 01.AI-assisted development with VS Code or Cursor
  • 02.Jetson device skills
  • 03.Jetson BSP custom agent skills
14.OpenClaw advanced development
01.Preparation Before Use
  • 01.Peripheral Hardware Configuration
  • 02.OpenClaw API-KEY Configuration
  • 03.OpenClaw Model Switching
  • 04.OpenClaw Prompts
  • 05.AI Voice Interaction Configuration
  • 06.Three Dialogue Configuration Tests
02.OpenClaw AI Programming Peripheral Control
  • 1. Servo Control
  • 2. RGB Strip
  • 3. OLED Display
  • 4. Temperature and Humidity Sensor
  • 5. Camera Application
  • 6. AI Script Peripheral Control
03.OpenClaw Peripheral Integration Applications
  • 1. Plant Care Assistant
  • 2. AI Calorie Estimation
  • 3. AI Rock Paper Scissors Game
  • 4. AI Pet
  • 5. AI Weather Station
  • 6. Temperature Humidity Dashboard
  • 7. Scheduled Tasks
Download
  • System_File
  • VMFile_BootFile
  • 3D Model File
  • DataSheet
  • Software_Tools
  • Code
  • Manual
Download ZIP

Welcome to Jetson Orin NANO Developer Kit repository

04.VNC remote control

VNC Remote Control

VNC Remote Control1. VNC Viewer1.1. Download VNC1.2. Install VNC1.3. Using VNC2. System Settings (Jetson)2.1. Switch to VNC Mode2.2. Confirm the Desktop and VNC Service2.3. VNC Password and Connection at Boot3. VNC Remote ControlCommon ProblemsCannot Find the VNC Switch of Remote DesktopMessage switch-remote-desktop: command not foundCannot Connect or Black Screen After ConnectionVNC Remote Display ReconnectionReconnection SymptomSolution

This tutorial applies to systems shipped with JetPack 7.2.1 / Ubuntu 24.04. It shares the local Jetson desktop through x11vnc, and Windows connects with VNC Viewer.

The "Settings → System → Remote Desktop" of Ubuntu 24.04 uses RDP and cannot serve as the server of VNC Viewer. This tutorial no longer uses the "Sharing → Remote Desktop → Legacy VNC" settings of Ubuntu 22.04. When RDP remote login is required, refer to RDP Remote Control.

The Windows computer needs VNC Viewer installed in advance, and must be on the same local area network as the Jetson.

1. VNC Viewer

1.1. Download VNC

Official download website: https://www.realvnc.com/en/connect/download/viewer/

img

1.2. Install VNC

Run VNC-Viewer-xxx.exe as administrator:

image.png

image.png

image.png

image.png

image.png

image.png

image.png

1.3. Using VNC

image.png

image.png

2. System Settings (Jetson)

2.1. Switch to VNC Mode

The shipped system has already configured x11vnc and the remote desktop mode switching script. Execute the following in the Jetson terminal or over SSH:

sudo switch-remote-desktop vnc

This command restores the local automatic login and the VNC shared desktop mode, and restarts gdm3. The switch interrupts the current graphical session; save your work in desktop programs before the operation, and confirm that backup connections such as SSH are available.

View the current mode:

xxxxxxxxxx
sudo switch-remote-desktop status

switch-remote-desktop is a script provided by the shipped system, not a built-in Ubuntu command. If you write the official NVIDIA clean system yourself, this script and the VNC service may be missing, so x11vnc needs to be installed and configured separately, and the switching steps of the shipped system cannot be copied directly.

2.2. Confirm the Desktop and VNC Service

The current VNC solution shares the local X11 desktop that is already logged in on the Jetson, usually the :0 session on the monitor. It does not create an independent remote desktop; when the local desktop has not been logged in yet, the graphical session has exited, or Wayland is in use, a direct connection cannot be made in this way.

Check the service and the listening port in the Jetson:

xxxxxxxxxx
systemctl status x11vnc.service --no-pager
ss -ltn | grep ':5900'

The service should show active (running) and listen on TCP 5900. If the service is not running, check the cause:

xxxxxxxxxx
journalctl -u x11vnc.service -b -n 50 --no-pager

Provided that the Jetson has entered the local desktop, you can try restarting the service and then check the status again:

xxxxxxxxxx
sudo systemctl restart x11vnc.service

Do not configure VNC by enabling the "Media Sharing" of Ubuntu; media sharing has nothing to do with VNC remote control. There is also no need to install the allow-locked-remote-desktop extension or clear the keyring password of "Passwords and Keys" as the old tutorials describe.

2.3. VNC Password and Connection at Boot

VNC Viewer uses the VNC access password configured in x11vnc, which is not necessarily the same as the Jetson system login password. Use the VNC password provided by the shipped system; do not use the credentials on the Ubuntu RDP page as a substitute.

If you need to troubleshoot the password configuration or change the password, first check the service startup parameters:

xxxxxxxxxx
systemctl cat x11vnc.service

If -rfbauth appears in the startup parameters, the path following it is the password file used by the service; when changing the password, operate on this actual file. Do not assume that the password of the existing service has been changed merely because you ran x11vnc -storepasswd to generate another file.

Automatic connection after boot requires all of the following at the same time: the x11vnc service is enabled, the local X11 desktop is logged in, and TCP 5900 is reachable. Check whether the service is set to start at boot:

xxxxxxxxxx
systemctl is-enabled x11vnc.service

If it shows disabled and the service has been verified as available in the previous section, you can enable it:

xxxxxxxxxx
sudo systemctl enable x11vnc.service

Enabling the service alone cannot replace the local desktop login. The VNC mode of the shipped system depends on local automatic login; after switching to RDP mode, automatic login is turned off, and you need to switch back to VNC mode to restore the original way of use. The connection behavior after the screen is locked should be confirmed on the current image; do not apply the effect of the old GNOME extension to x11vnc.

3. VNC Remote Control

Run hostname -I in the Jetson terminal to view the mainboard IP. Enter this IP in VNC Viewer; TCP 5900 is used by default, and you can also enter IP:5900 (replace IP with the actual address).

image-20241226153719054

Enter the VNC access password as prompted (see Section 2.3); do not use the system login password directly. The screenshots below only illustrate the client connection process; for the address and credentials in the old screenshots, refer to the current device.

image-20241226153812612

image-20241226154140728

Common Problems

Cannot Find the VNC Switch of Remote Desktop

The built-in remote desktop of Ubuntu 24.04 uses RDP. "Settings → System → Remote Desktop" cannot enable the x11vnc service of this tutorial; on the shipped system, use the mode switching command in Section 2.

Message switch-remote-desktop: command not found

Confirm whether the current system is the shipped system or the official clean system installed by yourself. This command is a shipped script; if it is missing, it cannot be made up by installing GNOME extensions. First check whether the x11vnc service has been installed and configured; if systemctl status x11vnc.service reports that the service does not exist, the VNC server needs to be configured separately.

Cannot Connect or Black Screen After Connection

First confirm that the IP of the computer and the Jetson are reachable, then check the service and the 5900 listening in Section 2.2. Confirm that VNC mode has been switched back, the Jetson local desktop is logged in, and the network or firewall is not blocking 5900. When no monitor is connected, you also need to confirm that the system has actually established a shareable X11 desktop; do not assume that VNC is available merely because SSH works.

VNC Remote Display Reconnection

Reconnection Symptom

image-20241226153930074

Solution

Modify the options of the corresponding remote device → specify the remote picture quality

image-20241226154023304

image-20241226154110695

image-20241226154145590

SSH remote login
RDP remote control

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文