https://github.com/jetsonhacks/install-docker
Install Docker on a JetPack 6 machine
https://github.com/jetsonhacks/install-docker
Last synced: 26 days ago
JSON representation
Install Docker on a JetPack 6 machine
- Host: GitHub
- URL: https://github.com/jetsonhacks/install-docker
- Owner: jetsonhacks
- License: mit
- Created: 2025-02-18T05:52:41.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-12T19:34:18.000Z (about 1 month ago)
- Last Synced: 2025-04-24T06:04:27.416Z (26 days ago)
- Language: Shell
- Size: 86.9 KB
- Stars: 11
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# install-docker
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](https://www.jetson-ai-lab.com/tips_ssd-docker.html) on the Jetson AI Lab website.
## Core Installation
Install nv-container and Docker on the rootfs
```bash
bash ./install_nvidia_docker.sh
```
## Configuration
Configure the Jetson to run Docker and take advantage of NVIDIA runtime
```bash
bash ./configure_nvidia_docker.sh
```
## Unhold and Upgrade Docker
**Important: 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.
## Downgrade Docker
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.
## Release Notes
### March 1, 2025
Docker release 28.0.1 still has significant issues on Jetson. The install scripts downgrade back to 27.5.1 again.
### February 27, 2025
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.
### February 22, 2025
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.
### February 2025
* Initial Release
* Tested on NVIDIA Jetson Orin Nano Super Developer Kit
Modified scripts from: [Jetson AI Lab - Tips - SSD + Docker](https://www.jetson-ai-lab.com/tips_ssd-docker.html)