DLI "Getting Started with AI on Jetson Nano" Course Environment Container

This container is used in the NVIDIA Deep Learning Institute course Getting Started with AI on Jetson Nano and should be run on an NVIDIA Jetson Nano. This course is also an element of the Jetson AI Fundamentals and the Jetson AI Certification Program. If you have not done so yet, we highly recommend you take the full free course, and check out other self-paced online courses and instructor-led workshops available from the NVIDIA Deep Learning Institute.

Prerequisites

The following are required to run this container.

• A compatible Jetson hardware developer kit:
  • NVIDIA Jetson Nano Developer Kit - JetPack 4.x
  • NVIDIA Jetson Nano 2GB Developer Kit - JetPack 4.x
  • NVIDIA Jetson AGX Orin Developer Kit - JetPack 6.x
  • NVIDIA Jetson Orin Nano Developer Kit - JetPack 6.x
• microSD memory card (64GB UHS-I minimum recommended) flashed with the current Jetson Nano Developer Kit SD Card image
• USB Camera such as Logitech C270 Webcam
• USB cable (Micro-B to Type-A)
• Internet connection for Jetson Nano to download this Docker image
• Compatible Power Supply (must be 5V 4A with 2.1mm DC barrel connector if using the original 4GB Jetson Nano Developer Kit)
• 2-pin jumper (original 4GB version only)
• Optional: monitor, keyboard, and mouse

How to Use the Container

If you've never used Docker, we recommend their Orientation and Setup.

Set the Data Directory

The data collected during the course is stored in a mounted directory on the host device. This way, the data and trained models aren't lost when the container shuts down. The commands below assume the mounted directory is ~/nvdli-data, so make sure you create it first:

mkdir ~/nvdli-data

Run the Container

Run the container using the container tag that corresponds to the version of JetPack-L4T that you have installed on your Jetson.

The docker run command will automatically pull the container if it is not on your system already.

USB Camera option:

sudo docker run --runtime nvidia -it --rm --network host \
 --volume ~/nvdli-data:/nvdli-nano/data \
 --device /dev/video0 \ 
 nvcr.io/nvidia/dli/dli-nano-ai:v2.0.3-r36.3.0

CSI camera option (original 4GB Nano and 2GB Nano only):

sudo docker run --runtime nvidia -it --rm --network host \
 --volume ~/nvdli-data:/nvdli-nano/data \
 --volume /tmp/argus_socket:/tmp/argus_socket \
 --device /dev/video0 \ 
 nvcr.io/nvidia/dli/dli-nano-ai:v2.0.2-r32.7.1

note: if you have both CSI (original 4GB Nano and 2GB Nano only) and USB cameras plugged in (or multiple USB cameras), also add --device /dev/video1 above. Then in the DLI notebooks, you will need to set the capture_device number to 1 (the CSI camera will be /dev/video0 and the USB camera will be /dev/video1 - don't use the CSI camera through V4L2)

Options Explained:

• --runtime nvidia will use the NVIDIA container runtime while running the l4t-base container
• -it means run in interactive mode
• --rm will delete the container when finished
• --network host allows the container to use your Jetson host network and ports
• --volume defines a mounting directory, and is used to share the persistent data files and the CSI camera socket between the Jetson host and the container
• --device allows access to the video device

Connect to JupyterLab

When the container is launched, the JupyterLab server will automatically be started. Text similar to the following will be printed out to the user:

allow 10 sec for JupyterLab to start @ https://192.168.55.1:8888 (password dlinano)
JupterLab logging location: /var/log/jupyter.log (inside the container)
You can then navigate the browser on your PC to the URL shown above (https://192.168.55.1:8888) and login to JupyterLab with the password dlinano. Then proceed with the DLI course as normal.

Technical Support

If you have any questions or need help, please visit the Jetson Developer Forums

License

Copyright 2020-2024 NVIDIA

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Base Image Used for This Container

Also used in this container, and with its own licensing:

• NVIDIA L4T PyTorch

Software Installed on Top of Base Image

Also used in this container, and with its own licensing:

• Node.js
• libffi-dev
• libssl1.0-dev
• JupyterLab
• jetcam