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:
73a9e5a6abeef6f89b5d4867b1b1fb20da11a4dd204bf90fca40337fb44979fe
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.20.1/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:
7b426801e595858af14a7b8c876cec4526282e9361fa2388bbb5f13dac0cb7d4
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.20.1/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:
9a5e1a09e06cc1f35f7ec5734fcd5f84818e1a7df00467dc87239f64a2dd56d6
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.20.1/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:
8e7fce83202b4a2743f478dc9735721977b909e2efda3e8b5413b82c59eb2b29
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.20.1/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:
888ba1be805c85c105e1ce970ca3443cb2bba81024645cad93a0e9fedcd91d50
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