Installation Using DRIVE OS Docker Containers

Note: The minimum required version of Docker Engine to run DRIVE OS Linux Docker containers is 19.03.

On the host system, download the type of Docker software needed for your organization (Enterprise, Desktop, or other) from https://www.docker.com/.

If you downloaded Docker as a Debian package (.deb), install Docker using dpkg with a command similar to the following, where <docker.deb> is replaced by the actual filename of the download: 
dpkg -i <docker.deb>
Alternatively, download an installation script from https://get.docker.com/ and install Docker on your host system with a command similar to the following: 
wget -gO- https://get.docker.com/ | $(SHELL)

NVIDIA GPU Cloud Access

In order to access NVIDIA GPU Cloud (NGC) (http://ngc.nvidia.com), you need an account specifically created on NGC. Contact your NVIDIA Account Representative to have NGC accounts created for your team.

Signing into NVIDIA GPU Cloud

Note: Make sure that you have received the NGC activation email and successfully activated your NGC Organization(s) and NGC Team(s) before proceeding.
  1. On the host system, sign into NGC (https://ngc.nvidia.com/) using your NVIDIA Developer credentials.
  2. Once you have signed in, select your NGC Organization. DRIVE OS SDK Docker Containers are located under PRIVATE REGISTRY.
  3. Once signed in, select Setup under the User menu in the top-right of the page to Generate an API Key in order to pull Docker images. For more information, see: https://docs.nvidia.com/ngc/ngc-overview/index.html#generating-api-key.
    Note: Using NVIDIA GPU Cloud is beyond the scope of this document. Please refer to the NVIDIA GPU Cloud documentation for more information.
  4. From the command line on your host system, log on to the NVIDIA GPU Cloud with your username and API key with the following command. Replace ${YOUR_USERNAME} and ${YOUR_API_KEY} with your username and API key respectively. 
    sudo docker login -u="${YOUR_USERNAME}" -p "${YOUR_API_KEY}" nvcr.io
    Note: ${YOUR_USERNAME} is commonly $oauthtoken. Note the $ is part of the username.

    See Docker Login documentation for more information on login methods.

After you log in, you have access to NVIDIA DRIVE OS SDK Docker images, depending on your specific permissions in the registry.

Setting Up DRIVE OS Linux

The following images are available on NGC in this release:

File Name Intent
drive-agx-orin-linux-aarch64-sdk-build-x86:latest Build and Flash DRIVE 14 Linux SDK
drive-agx-orin-linux-aarch64-sdk-flash-x86:latest Flash DRIVE 14 Linux SDK

Pulling Docker Images from NGC

This example pulls and uses the following NVIDIA DRIVE SDK build/flash image:

  1. Log into the NVIDIA GPU Cloud (NGC) using instructions in the previous section.
  2. On the host system, pull the image using the following command.
    Note: ${MY_NGC_ORG} is the NGC Organization allocated for your team.
    sudo docker pull nvcr.io/${MY_NGC_ORG}/drive-sdk/drive-agx-orin-linux-aarch64-sdk-build-x86:latest

Running Linux SDK Docker

After successfully pulling the Docker image, start the Docker container with the following command on the host system after replacing variables with values for your env (in bold below): 
sudo docker run -it --privileged --net=host -v /dev/bus/usb:/dev/bus/usb -v ${NV_WORKSPACE}:/home/nvidia/ 
nvcr.io/${MY_NGC_ORG}/driveos-sdk/drive-agx-orin-linux-aarch64-sdk-build-x86:latest
Note: Enter all subsequent commands at the Docker container command prompt.