NVIDIA NIM is containerized software for fast, reliable AI model serving and inference on NVIDIA GPUs. This playbook shows how to run NIM microservices for LLMs on your hardware platform through a simple Docker workflow: authenticate with NVIDIA's registry, launch the NIM inference microservice, and validate the OpenAI-compatible HTTP endpoint.
You'll launch a NIM container on your hardware platform to expose a GPU-accelerated HTTP endpoint for chat completions. These instructions use the Nemotron 3.5 Lightning 30B-A3B NIM as the default example; additional NIM containers are available in the NGC catalog (see Find model recipes).
Required:
Optional:
Use the matrix below to confirm your hardware platform, recommended default local settings, and whether multi-node applies.
| Hardware platform | OS | Memory | Recommended default local settings | Multi-node capable hardware |
|---|---|---|---|---|
| DGX Spark | DGX OS (Linux) | 64GB or 128GB Unified Memory | nvcr.io/nim/nvidia/nemotron-3.5-lightning-30b-a3b:latest | — |
For full hardware x NIM support details, see NIM for LLMs support matrix.
Hardware requirements
Software requirements
nvidia-smi docker run -it --gpus=all nvcr.io/nvidia/cuda:13.0.1-devel-ubuntu24.04 nvidia-smi
echo $NGC_API_KEY | grep -E '^[a-zA-Z0-9]{86}=='
nvcr.io) to pull containers and download model assetsBrowse NIM containers for your hardware platform in the NVIDIA NGC catalog and the NIM for LLMs supported models list. Each container page includes pull and run guidance for that model.
| Hardware platform | More recipes |
|---|---|
| DGX Spark | Nemotron 3.5 Lightning 30B-A3B NIM · Llama 3.1 8B Instruct NIM for DGX Spark · Qwen3-32B NIM for DGX Spark · NIM for LLMs supported models |
Use the Instructions tab for the base Docker workflow with the default Nemotron 3.5 Lightning 30B-A3B NIM.
NOTE
Nemotron 3.5 Lightning does not use a -dgx-spark container variant. Unlike the Llama and Qwen3 recipes above, it ships as a single multi-platform container that lists NVIDIA-GB10 among its verified GPUs and supports all published profiles there. See Get Started with Nemotron 3.5 Lightning for profile selection and pinned variant tags.
NOTE
Memory and disk determine what you can run. Larger NIMs need more unified memory and cache space. If a model is not listed for your hardware platform, check the container page and supported-models list before downloading.
docker stop <CONTAINER_NAME> && docker rm <CONTAINER_NAME>. Remove cached models from ~/.cache/nim only if you need the disk space (requires re-download on next run).