Configuring NVIDIA GPU Cloud (NGC) Access for NVIDIA Developer Users#

To download NVIDIA DriveOS™ 7.0 Linux Docker images as an NVIDIA Developer user, you must configure access to NVIDIA GPU Cloud Access (NGC), which is the container registry that stores the images.

  1. Ensure Docker Engine 19.03 or greater is installed on your host system:

    • Install the type of Docker software required for your organization (Enterprise, Desktop, etc.) from https://www.docker.com.

    • Alternatively, download an installation script from https://get.docker.com/ to install Docker on your host system by running a command similar to the following:

      $ wget -qO- https://get.docker.com/ | ${SHELL}
      
  2. On the host system, sign into NGC (https://ngc.nvidia.com) by using your NVIDIA Developer credentials.

  3. After signing in, select your NGC Organization (for NVIDIA Developer users, the drive organization) and the driveos-sdk team in the upper-right drop-down menus:

    Screenshot from NGC showing selection of the drive organization and driveos-sdk team
  4. Select Private Registry in the upper-left drop-down menu.

    Then, go to Containers in the left navigation and filter by Thor to click on the card for the [Thor] DRIVE OS Linux SDK Build Docker image:

    Screenshot from NGC showing selection of Private Registry and Containers
  5. Go the Tags tab and click the copy icon on the right side of the desired image version, which copies the full image reference, including the version and build tag:

    Screenshot from NGC showing copying the image reference with version and build tag

    Important

    Note this version and build tag for later use when referencing the image with docker run commands in Installing NVIDIA DriveOS for NVIDIA Developer Users.

  6. Select Setup in the upper-right drop-down menu, then click Generate API Key:

    Screenshot from NGC showing selecting Setup then Generate API Key

    Tip

    For more information on generating API keys, see the NGC User Guide.

  7. Click + Generate Personal Key, then complete the form in the window that appears:

    1. Provide values for the Key Name and Expiration fields as desired.

    2. In the Services Included drop-down menu, select Private Registry.

    3. Click Generate Personal Key in the lower-right.

    Screenshot from NGC showing generation of a personal key
  8. Your generated personal API key is displayed in the next window that appears; click Copy Personal Key or the copy icon and note your key for use in a later step:

    Screenshot from NGC showing the generated personal key that must be copied

    Important

    This is the only time your key will be displayed. Ensure that you copy it to a secure place before closing this window.

  9. On your host system, log in to the NGC container registry by running the following command:

    $ sudo docker login nvcr.io
    
  10. When prompted for your username, enter the following text:

    $oauthtoken
    

    Note

    The $oauthtoken username is a special username that indicates that you will authenticate with an API key instead of a username and password.

  11. When prompted for your password, replace <your_api_key> as shown in the following example with your personal API key that you generated from NGC:

    Username: $oauthtoken
    Password: <your_api_key>
    

    Note

    If there is an issue, request support at the NVIDIA Developer Forum.

After successfully logging in, you now have access to NVIDIA DriveOS Docker images, depending on your specific permissions in the registry, and can continue to Installing NVIDIA DriveOS for NVIDIA Developer Users.