Nvidia-smi-exporter
Prometheus exporter that scrapes NVIDIA GPU metrics via nvidia-smi for self-hosted monitoring, supporting all GPU architectures (Turing through Blackwell) and…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
41/100 Fair
- Maintained
- 63last commit 142 days ago
- Popular
- 123 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 28 days ago
- GitHub stars
- 3
- Open issues
- 0
- Last commit
- 2026-07-01
- Latest release
- v2026.07.01
- Activity
- stale
Checked 9 days ago - source: GitHub (ccmpbll/nvidia-smi-exporter)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Confirm Docker can see your GPU Run the docker nvidia-smi command in the docs before installing. If it fails, fix the NVIDIA Container Toolkit or Docker GPU runtime first, because the exporter cannot report GPU metrics without it. source
- Install with Helm and use a values file Use helm install dcgm-exporter ./deployment, or add -f my-values.yaml to set custom options. This creates the exporter deployment, and a values file keeps your settings easy to rerun or audit. source
- Point debug logs at a safe host folder If you enable debugDump, set directory to a persistent host path such as /var/log/dcgm-exporter-debug. The default /tmp location can disappear after restarts, so you may lose useful troubleshooting logs. source
- NVIDIA Driver Requirement On Unraid, install the NVIDIA-Driver community plugin before deploying this container so Docker can access the GPU. source
Fetched 47 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What Docker prerequisite must be in place before running the exporter in a container?
The host must have the NVIDIA Container Toolkit installed so Docker can use the NVIDIA runtime. The exporter is run with the NVIDIA runtime, and the image includes nvidia-smi from the CUDA base image.
How can I limit the exporter to only some GPUs?
Set NVIDIA_VISIBLE_DEVICES to all for every GPU, one or more indexes like 0 or 0,1, a GPU UUID with GPU-, or none to disable GPU access.
Which port and environment variable control the HTTP metrics endpoint?
The exporter listens on the EXPORTER_PORT environment variable, which defaults to :9202. Expose 9202/tcp for Docker, and scrape the /metrics path for Prometheus metrics.
Why does this exporter exist for driver 595+?
Driver 595+ changed some nvidia-smi -q -x fields from N/A to a deprecation string, which made the original exporter emit an empty Prometheus value and fail the whole scrape silently. This version filters every value to a valid numeric string or 0 and refuses to emit empty metric lines.
Answers sourced from github.com
Community
- Reddit (reddit)
- NVIDIA-SMI UI - Megaton Check it out! : r/selfhosted - Reddit (reddit)
- Restrictions, precautions, and operational notes for using nvidia-smi (forum)
- NVIDIA-SMI Shows ERR! on Fan Usage - General Discussion - NVIDIA ... (forum)
- [Plugin] Nvidia-SMI Exporter - Plugin Support - Unraid (forum)
Collected 48 days ago - public community threads