# doca-setup

doca-setup is a Claude Code skill that validates and configures NVIDIA DOCA environments for BlueField DPUs, checking library paths, hugepages, and devlink before network workloads run.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 4106 repo stars
- Author: NVIDIA
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-setup/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/doca-setup

## What it does

The skill evaluates host readiness for NVIDIA DOCA 3.5 workloads. It inspects whether the target environment is an x86 host, an Arm bare-metal DPU, or a local machine without accelerator cards. For hosts lacking local hardware, it directs the developer toward the NGC container workflow.

Included routines audit `/opt/mellanox/doca`, verify headers, fix `pkg-config` flags, configure `LD_LIBRARY_PATH`, and inspect 2048 kB hugepages. The skill also tracks devlink parameters and network representors.

The skill strictly separates environment setup from application logic: it declines requests to draft DOCA Flow pipes or configure RDMA queues. Changing eswitch modes or running `mlxconfig` disrupts host networking, so the skill requires explicit confirmation before applying changes.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-setup -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/doca-setup/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/doca-setup/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-setup -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/doca-setup/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-setup -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/doca-setup/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills skills/doca-setup
```

2. **Manually: put the files in place**
- File: `.github/skills/doca-setup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-setup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/doca-setup
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/doca-setup/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-setup/SKILL.md

## When to use it
- resolve missing build flags when `pkg-config` cannot locate DOCA libraries
- verify install health in `/opt/mellanox/doca`
- allocate 2048 kB hugepages and inspect representors on BlueField hosts
- spin up a DOCA sandbox on macOS using the NVIDIA NGC container

## Example prompts
- Verify whether the DOCA installation on this machine is ready for workloads
- My code is built on BlueField, what runtime preconditions do I need to configure?
- pkg-config cannot find doca-flow, how do I fix the build flags?

## Similar
- [homelab-network-setup](https://affpapa.org/en/nevibecode/skills/homelab-network-setup.md) — skill · 6200 installs
- [physical-ai-infrastructure-setup-and-resilient-scaling](https://affpapa.org/en/nevibecode/skills/physical-ai-infrastructure-setup-and-resilient-scaling.md) — skill · ★ 8052 repo stars
- [huawei-cloud-network-query](https://affpapa.org/en/nevibecode/skills/huawei-cloud-network-query.md) — skill · 18400 installs
- [configuring-vpc-endpoints-for-private-aws-service-access](https://affpapa.org/en/nevibecode/skills/configuring-vpc-endpoints-for-private-aws-service-access.md) — skill · 7200 installs
- [aws-networking](https://affpapa.org/en/nevibecode/skills/aws-networking.md) — skill · 7000 installs
- [gke-networking](https://affpapa.org/en/nevibecode/skills/gke-networking.md) — skill · 6551 installs

From the same set: [nvidia/skills](https://affpapa.org/en/nevibecode/by/nvidia/skills.md) — 312 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
