Install Docker on a JetPack 6 machine
One of the changes from the previous version of JetPack versus JetPack 6 is that the SDK Manager does not install Docker by default. The SD card install for a Jetson Orin Nano incudes Docker, but host installs do not. These convenience scripts install Docker and configure it for use on the Jetson.
These scripts install Docker on the rootfs, and are meant for systems that run from a SSD. On a Jetson Orin Nano Developer Kit, if you want to use your SSD strictly as a separate data store and boot from the SD card, do not use these scripts. Instead see: Tips - SSD + Docker on the Jetson AI Lab website.
Install nv-container and Docker on the rootfs
bash ./install_nvidia_docker.shConfigure the Jetson to run Docker and take advantage of NVIDIA runtime
bash ./configure_nvidia_docker.shImportant: It is not currently safe to perform this. The Docker 28.0.0 release broke Docker on Jetson because of a dependency on kernel modules ip_set, ip_set_hash_net and netfilter_xt_set which are not set in the default Jetson kernel. The work around is to downgrade the Docker files to 27.5.1 and mark them as 'hold' so that they would not be updated when performing an apt upgrade. If you installed Docker using these scripts previously and the Docker packages were downgraded and held, you can undo the hold and upgrade using this script:
bash unhold_and_upgrade_docker.sh
which will 'mark unhold' the held packages and upgrade them.
An issue with Docker 28.0.0 (released 2/20/2025) requires changes to the kernel which are not implemented in the current Jetson 6.2 release. 28.0.1 addressed the issue, but did not solve the problem. If you have Docker installed, and after an apt upgrade the Docker daemon will not run, you can downgrade to Docker 27.5.1 using the downgrade_docker.sh script:
bash ./downgrade_docker.sh
Docker is downgraded to 27.5.1 and the packages are marked hold so that apt upgrade will not upgrade them automatically.
JetPack 6.2.1 fixes the iptable issue. Removed downgrade from the install_docker script.
Docker release 28.0.1 still has significant issues on Jetson. The install scripts downgrade back to 27.5.1 again.
Docker release 28.0.1 reverted the kernel modules ip_set, ip_set_hash_net and netfilter_xt_set requirements. The new installation script does not downgrade and mark hold the Docker packages. In addition, unhold_and_upgrade.sh was added to upgrade the held packages from the previous install.
An issue with Docker 28.0.0 (released 2/20/2025) requires changes to the kernel which are not implemented in the current Jetson 6.2 release:
CONFIG_IP_SET=m
CONFIG_IP_SET_HASH_NET=m
CONFIG_NETFILTER_XT_SET=m
The install_nvidia_docker.sh script incorporates the current work around which is to downgrade to Docker 27.5.1. Also, Docker is marked hold so that apt upgrade doesn't inadvertently upgrade the package. Apparently the settings are forward in the Ubuntu 24.04, and are not implemented in the Jetson 22.04 derived OS.
- Initial Release
- Tested on NVIDIA Jetson Orin Nano Super Developer Kit
Modified scripts from: Jetson AI Lab - Tips - SSD + Docker