NGC CLI
Windows 64-bit Install
The NGC CLI binary for Windows is supported on Windows Vista and later.
Download the CLI installer, then check the installer's SHA256 hash to ensure the file wasn't corrupted during download. Run the following command to get the SHA256 hash:
$ Get-FileHash .\ngccli_win_amd64.exe
Then compare with the following value, which can also be found in the Release Notes of the Resource:
46b973a79cf9ef22bb0b66ceb21c2042e87613c03ed0be47c099d0de858b2988
After verifying value, double-click the downloaded file to launch the NVIDIA installer and follow the instructions in the installer.
You must configure NGC CLI for your use so that you can run the commands.
Enter the following command and follow the prompts:
$ ngc config set
Windows 64-bit Uninstall:
Uninstall using Windows Add/Remove Programs.
AMD64 Linux Install
The NGC CLI binary for Linux is supported on Ubuntu 16.04 and later distributions.
Click Download CLI to download the zip file that contains the binary, then transfer the zip file to a directory where you have permissions and then unzip and execute the binary. You can also download, unzip, and install from the command line by moving to a directory where you have execute permissions and then running the following command:
$ wget --content-disposition https://api.ngc.nvidia.com/v2/resources/nvidia/ngc-apps/ngc_cli/versions/4.34.7/files/ngccli_linux.zip -O ngccli_linux.zip && unzip ngccli_linux.zip
Check the binary's md5 hash to ensure the file wasn't corrupted during download:
$ find ngc-cli/ -type f -exec md5sum {} + | LC_ALL=C sort | md5sum -c ngc-cli.md5
Check the binary's SHA256 hash to ensure the file wasn't corrupted during download. Run the following command
$ sha256sum ngccli_linux.zip
Compare with the following value, which can also be found in the Release Notes of the Resource:
0184ee4250b93d7237f81f4abc26885c0b1732f29a053f2f2d5314222ee77dff
After verifying value, make the NGC CLI binary executable and add your current directory to path:
$ chmod u+x ngc-cli/ngc
$ echo "export PATH=\"\$PATH:$(pwd)/ngc-cli\"" >> ~/.bash_profile && source ~/.bash_profile
You must configure NGC CLI for your use so that you can run the commands.
Enter the following command, including your API key when prompted:
$ ngc config set
Linux Uninstall:
Warning: If you choose to have a custom path for your installation, or move the CLI Binary, these instructions may not be safe.
For CLI versions 3.0.0 and up:
- Check
dirname `which ngc`.
If this directory can be deleted, move to the next step. If not, move to step 3.
- Delete the NGC CLI directory:
Enter the following command.
$ dirname `which ngc` | xargs rm -r
- Delete the NGC CLI Binary. Enter the following command.
$ which ngc | xargs rm
This does not delete all files downloaded from the initial NGC CLI installation. Please go to the original installation folder and delete it.
ARM64 Linux Install
The NGC CLI binary for ARM64 is supported on Ubuntu 18.04 and later distributions.
Click Download CLI to download the zip file that contains the binary, then transfer the zip file to a directory where you have permissions and then unzip and execute the binary. You can also download, unzip, and install from the command line by moving to a directory where you have execute permissions and then running the following command:
$ wget --content-disposition https://api.ngc.nvidia.com/v2/resources/nvidia/ngc-apps/ngc_cli/versions/4.34.7/files/ngccli_arm64.zip -O ngccli_arm64.zip && unzip ngccli_arm64.zip
Check the binary's md5 hash to ensure the file wasn't corrupted during download:
$ find ngc-cli/ -type f -exec md5sum {} + | LC_ALL=C sort | md5sum -c ngc-cli.md5
Check the binary's SHA256 hash to ensure the file wasn't corrupted during download. Run the following command
$ sha256sum ngccli_arm64.zip
Compare with the following value, which can also be found in the Release Notes of the Resource:
2e26d54d832fe02591940f8ee7990bb077a17af54b2831268af2c83ef5e4c8b9
After verifying value, make the NGC CLI binary executable and add your current directory to path:
$ chmod u+x ngc-cli/ngc
$ echo "export PATH=\"\$PATH:$(pwd)/ngc-cli\"" >> ~/.bash_profile && source ~/.bash_profile
You must configure NGC CLI for your use so that you can run the commands.
Enter the following command, including your API key when prompted:
$ ngc config set
ARM64 Uninstall:
Warning: If you choose to have a custom path for your installation, or move the CLI Binary, these instructions may not be safe.
For CLI versions 3.0.0 and up:
- Check
dirname `which ngc`.
If this directory can be deleted, move to the next step. If not, move to step 3.
- Delete the NGC CLI directory:
Enter the following command.
$ dirname `which ngc` | xargs rm -r
- Delete the NGC CLI Binary. Enter the following command.
$ which ngc | xargs rm
This does not delete all files downloaded from the initial NGC CLI installation. Please go to the original installation folder and delete it.
macOS Intel Installer
The NGC CLI binary for macOS is supported on macOS 10.13 and later.
Click Download CLI to download the installer or use the following command to download the installer:
$ curl -LO https://api.ngc.nvidia.com/v2/resources/nvidia/ngc-apps/ngc_cli/versions/4.34.7/files/ngccli_mac_intel.pkg
Check the installer's SHA256 hash to ensure the file wasn't corrupted during download. Run the following command to get the SHA256 Checksum:
$ shasum -a 256 ngccli_mac_intel.pkg
Then compare with the following value, which can also be found in the Release Notes of the Resource:
05c16b270d49df2364f66b4e3ab663afe424b15db83dd0647435d72e341808d3
After verifying value, run installer to install CLI:
$ sudo installer -pkg ngccli_mac_intel.pkg -target /usr/local
Make sure that you have set up localization to support UTF-8 by setting LC_ALL in ~/.bash_profile. For example:
$ export LC_ALL=en_US.UTF-8
You must configure NGC CLI for your use so that you can run the commands.
$ ngc config set
macOS Intel Uninstall
Remove the binary file and it's dependencies:
$ sudo rm -rf /usr/local/ngc-cli/ /usr/local/bin/ngc
macOS ARM Installer
The NGC CLI binary for macOS is supported on macOS 10.13 and later.
Click Download CLI to download the installer or use the following command to download the installer:
$ curl -LO https://api.ngc.nvidia.com/v2/resources/nvidia/ngc-apps/ngc_cli/versions/4.34.7/files/ngccli_mac_arm.pkg
Check the installer's SHA256 hash to ensure the file wasn't corrupted during download. Run the following command to get the SHA256 Checksum:
$ shasum -a 256 ngccli_mac_arm.pkg
Then compare with the following value, which can also be found in the Release Notes of the Resource:
e99c8ed1802679ce04b5725798d1bf4f5ac5956ce4474e2652f4d67ae40e35e6
After verifying value, run installer to install CLI:
$ sudo installer -pkg ngccli_mac_arm.pkg -target /usr/local
Make sure that you have set up localization to support UTF-8 by setting LC_ALL in ~/.bash_profile. For example:
$ export LC_ALL=en_US.UTF-8
You must configure NGC CLI for your use so that you can run the commands.
$ ngc config set
macOS ARM Uninstall
Remove the binary file and it's dependencies:
$ sudo rm -rf /usr/local/ngc-cli/ /usr/local/bin/ngc