{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Download with NGC CLI","siteUrl":"https://docs.hiddenlayer.ai","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"download-with-ngc-cli","__idx":0},"children":["Download with NGC CLI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/products/supply-chain/cli/usage_examples#scan-a-nim-container"},"children":["scanning a NIM container"]},", use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://org.ngc.nvidia.com/setup/installers/cli"},"children":["NVIDIA GPU Cloud (NGC) CLI"]}," to download model artifacts listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["summary.referenced_models"]},". Supply Chain does not download these files during the container scan. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/products/supply-chain/cli/nim_container"},"children":["NIM Container Scanning"]}," for manifest parsing and advisory details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-referenced-files-must-be-downloaded","__idx":1},"children":["Why Referenced Files Must Be Downloaded"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc://"]}," is not a supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--input"]}," scheme."]}," Supply Chain accepts local paths, cloud storage URLs, Hugging Face URLs, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oci://"]}," container references — not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc://"]}," artifact URIs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NGC serves model files over authenticated HTTPS APIs."]}," Individual model artifacts require NGC credentials (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NGC_API_KEY"]},") to download."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The scanner does not pass NGC credentials to artifact download endpoints."]}," While ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NGC_API_KEY"]}," is used to pull ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oci://nvcr.io/nim/..."]}," container images, that credential is not applied when fetching files referenced by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc://"]}," URIs in the manifest."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create an API key in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://org.ngc.nvidia.com/setup/api-key","target":"_blank"},"children":["NGC portal"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set the environment variable:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"export NGC_API_KEY=<your-api-key>\n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure the CLI:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"ngc config set\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide your API key when prompted."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parse-a-referenced-uri","__idx":3},"children":["Parse a referenced URI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Referenced models from a NIM container scan use this URI format:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"ngc://{org}/{team}/{model}:{version}?file={filename}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Map the URI to an NGC CLI download command:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"URI component"},"children":["URI component"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"NGC CLI argument"},"children":["NGC CLI argument"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc://{org}/{team}/{model}:{version}?file={filename}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc registry model download-version {org}/{team}/{model}:{version} --file {filename}"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Referenced URI"},"children":["Referenced URI"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Download command"},"children":["Download command"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc://nim/nvidia/test-model:1.0.0?file=model.bin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ngc registry model download-version nim/nvidia/test-model:1.0.0 --file model.bin"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"follow-up-scan","__idx":4},"children":["Follow-up scan"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After downloading artifacts, scan the files locally using Supply Chain CLI. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/products/supply-chain/cli/usage_examples#scanning-a-single-file"},"children":["Scanning a single file"]}," in Usage Examples for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["docker run"]}," commands."]}]},"headings":[{"value":"Download with NGC CLI","id":"download-with-ngc-cli","depth":1},{"value":"Why Referenced Files Must Be Downloaded","id":"why-referenced-files-must-be-downloaded","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Parse a referenced URI","id":"parse-a-referenced-uri","depth":2},{"value":"Follow-up scan","id":"follow-up-scan","depth":2}],"frontmatter":{"seo":{"title":"Download with NGC CLI"}},"lastModified":"2026-06-30T21:42:46.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/products/supply-chain/cli/ngc_cli_download","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}