Prerequisites

HPC containers are available to run on Linux systems equipped with NVIDIA GPUs of architecture Pascal or later. Linux distributions that are supported include Ubuntu 16.04.

To enable portability in Docker images that leverage GPUs, NVIDIA developed nvidia-docker, an open-source project that provides a command line tool to mount the user mode components of the NVIDIA driver and the GPUs into the Docker container at launch.

NGC containers take full advantage of NVIDIA GPUs and require nvidia-docker.
Note: HPC Visualization Containers have different prerequisites. For more information, see index.html#hpc-vis-container.
  • DGX™ users should follow the step-by-step instructions on how to install Docker and nvidia-docker in the Preparing to use NVIDIA Containers Getting Started Guide.
  • Amazon Web Services (AWS) P3 users should follow the step-by-step instructions in the Using NGC with AWS Setup Guide.
  • Users other than AWS should follow the nvidia-docker installation documentation at nvidia-docker installation and install the latest NVIDIA Display driver for your GPU product type and series for your operating system. If NVIDIA drivers are not already configured on your system, then install them from here: Download Drivers.
  • Ensure you have an NVIDIA GPU supporting Compute Unified Device Architecture® (CUDA) version with compute capability 6.0.0 or higher. For example, Pascal GPU architecture generation or later.
  • Log into the NVIDIA® GPU Cloud (NGC) Container Registry located at nvcr.io using your NGC API key. For step-by-step instructions on how to gain access and get your API key, see NGC Getting Started Guide.