Node Locked License, Singularity Container

Installing Parabricks via the Singularity container installer requires the following:

  • A working Nvidia driver,

  • A working singularity setup

  • Installer package, something similar to parabricks.tar.gz

You can refer to the section Installation Requirements for more details

This section assumes you have the installer package as parabricks.tar.gz either through the Trial Process or through the License Portal. For node locked licenses, you should have requested a license.bin from


# Extract the installation package. $ tar -xzf parabricks.tar.gz # Install the software. $ sudo ./parabricks/ --container singularity # Verify your installation. # This should display the parabricks version number: $ pbrun version


Installing the Singularity version of Parabricks differs from installing the Docker version in the third step listed above--specifically in the addition of the --container singularity option when running ./parabricks/

During the installation you'll be asked

  1. To accept the end user license agreement.

  2. If you want to create a symbolic link from the Parabricks installation to /usr/bin/pbrun (requires :code`sudo` access).

  3. If you want to install the Ampere version or the non-Ampere version.

To check if your system has Ampere GPUs, run the following:


nvidia-smi --query-gpu=name --format=csv,noheader

Any GPU labeled with the first letter A (e.g. 'Tesla A100', 'Tesla A40') is an Ampere GPU.


If your machine has more GPUs than you have licenses, you will need to specify which, and how many, GPUs to use. For example, use the following flags to select only the first two GPUs:


CUDA_VISIBLE_DEVICES="0,1" pbrun [command and inputs] --num-gpus 2

After installation, the pbrun command will start any tool in the Parabricks software suite. Answering "yes" to the second question (about creating a symbolic link) will make pbrun available for system-wide access. Otherwise, you can access pbrun from your local installation directory, which is /opt/parabricks/pbrun by default.

© Copyright 2022, Nvidia. Last updated on Jun 28, 2023.