---
title: "How to Check and Configure NVIDIA GPUDirect Storage for Your Platform"
description: "NVIDIA GPUDirect Storage (GDS) accelerates GPU storage access by providing a direct data path between GPUs and storage, reducing latency and CPU overhead. The gds-diag tool, an open-source command-line utility distributed via the NVIDIA Magnum IO GitHub repository, simplifies configuring and optimizing GDS deployments by assessing environments, identifying problems, and suggesting improvements. It includes an optional AI agent skill that adds a natural-language interface and orchestration layer for multi-step diagnostics, working with coding assistants like Claude and Codex. The tool supports bare-metal, virtual machine, and container environments, and its subcommands include pre-install, post-install, config-audit, mount-check, and container-check, with each finding having a status badge (FAIL, WARN, INFO, PASS) and a mitigation plan. It requires Python 3.8 or newer, does not modify the system, and can output findings as structured JSON, while the support-matrix subcommand shows supported platform combinations with color-coded compatibility."
---

# How to Check and Configure NVIDIA GPUDirect Storage for Your Platform

[NVIDIA](https://yomu.fyi/company/nvidia-developer-blog) · Phil Carns · Oct 30, 2026

**Type:** Tutorial

## Summary

NVIDIA GPUDirect Storage (GDS) accelerates GPU storage access by providing a direct data path between GPUs and storage, reducing latency and CPU overhead. The gds-diag tool, an open-source command-line utility distributed via the NVIDIA Magnum IO GitHub repository, simplifies configuring and optimizing GDS deployments by assessing environments, identifying problems, and suggesting improvements. It includes an optional AI agent skill that adds a natural-language interface and orchestration layer for multi-step diagnostics, working with coding assistants like Claude and Codex. The tool supports bare-metal, virtual machine, and container environments, and its subcommands include pre-install, post-install, config-audit, mount-check, and container-check, with each finding having a status badge (FAIL, WARN, INFO, PASS) and a mitigation plan. It requires Python 3.8 or newer, does not modify the system, and can output findings as structured JSON, while the support-matrix subcommand shows supported platform combinations with color-coded compatibility.

## Context

NVIDIA GPUDirect Storage (GDS) accelerates GPU storage access by providing a direct data path between GPUs and storage, increasing bandwidth and reducing latency and CPU overhead. Configuring GDS requires navigating extensive documentation for supported architectures and storage solutions. The gds-diag tool was developed to simplify optimization and configuration of GDS deployments.

## Approach / What changed

Use the gds-diag tool, available as a command-line utility or an AI agent skill, to assess GDS environments, identify problems, and suggest improvements. The command-line tool provides deterministic checks via subcommands like pre-install, post-install, config-audit, mount-check, and container-check. The AI agent skill adds natural-language interaction and can interpret results and propose remediation. gds-diag requires Python 3.8+ and is distributed via the NVIDIA Magnum IO GitHub repository.

## Takeaways

- gds-diag is an open-source command-line utility that assesses GDS environments, identifies problems, and suggests improvements without modifying the system.
- The tool includes an optional AI agent skill that works with coding assistants like Claude and Codex to provide natural-language diagnostics and orchestration.
- gds-diag supports bare-metal, virtual machine, and container environments, and can output findings as structured JSON for integration with other tools.

## FAQ

### How do I install gds-diag?

Clone the NVIDIA Magnum IO GitHub repository and navigate to the gds-diag directory. It requires Python 3.8 or newer and has no other dependencies. You can then run it as a command-line tool or open it in an AI coding assistant for the agent skill.

### What subcommands are available in gds-diag?

Subcommands include all (end-to-end checks), pre-install, post-install, config-audit, support-matrix, container-check, and mount-check. Each focuses on different diagnostic tasks, and you can see details with --help.

### How does the AI agent skill work?

The agent skill activates automatically when you open the gds-diag repository in a coding assistant like Claude or Codex. It interprets natural language queries, selects appropriate gds-diag subcommands, and can interpret results and propose remediation actions.

**Tags:** [AI Agents](https://yomu.fyi/topic/ai-agents), [GPU](https://yomu.fyi/topic/gpu), [GPUDirect Storage](https://yomu.fyi/topic/gpudirect-storage), [NVIDIA](https://yomu.fyi/topic/nvidia), [Storage](https://yomu.fyi/topic/storage)

- Source: [NVIDIA](https://developer.nvidia.com/blog/how-to-check-and-configure-nvidia-gpudirect-storage-for-your-platform)
- Source URL: https://developer.nvidia.com/blog/how-to-check-and-configure-nvidia-gpudirect-storage-for-your-platform
- Ingested by Yomu: 2026-10-30T18:00:13.504Z

[Read original post](https://developer.nvidia.com/blog/how-to-check-and-configure-nvidia-gpudirect-storage-for-your-platform)
