Troubleshooting Guide#

This page collects common setup issues for Jetson Orin Nano Developer Kit.

Jetson ISO Does Not Boot#

If the developer kit does not boot from the Jetson ISO USB flash drive:

  1. Confirm that the USB flash drive was written as bootable media, not copied as a file.

  2. Try a different USB port or USB flash drive.

  3. Enter the UEFI setup menu by pressing Esc during boot.

  4. Select the USB flash drive from Boot Manager.

  5. Confirm that the developer kit firmware is compatible with the JetPack release. See JetPack 6.x Update Path.

No Display Output#

If the monitor remains blank:

  • Connect the monitor directly to the DisplayPort connector instead of through a KVM switch or adapter chain.

  • Confirm the monitor is powered on before powering the developer kit.

  • Try the headless serial method described in Quick Start Guide or JetPack 6.x Update Path.

Installer Does Not Show Target Storage#

If the Jetson ISO installer does not show your storage device:

  • For microSD, confirm the card is fully inserted in the module slot.

  • For NVMe SSD, confirm the SSD is installed in the carrier board connector and secured.

  • Reboot into the installer after reseating the storage device.

  • Review Hardware Layout for connector locations.

Firmware Update Is Needed#

Some developer kits require a Jetson UEFI and QSPI firmware update before booting newer JetPack releases.

Use JetPack 6.x Update Path if:

  • The system fails to boot a newer JetPack release.

  • The display remains black or drops to a UEFI shell.

  • You do not know whether the firmware is compatible with the target JetPack release.

Docker Permission Error#

If Docker reports a socket permission error:

sudo usermod -aG docker $USER
newgrp docker

Restart your terminal session if the group change does not take effect immediately.