> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/brev/latest/troubleshooting/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/brev/_mcp/server.

# Troubleshooting

## Docs

- [Troubleshooting](https://docs.nvidia.com/brev/latest/troubleshooting/troubleshooting-overview.md): Diagnose and resolve common issues with NVIDIA Brev CLI, connectivity, GPU detection, and instance management.
- [Common Issues](https://docs.nvidia.com/brev/latest/troubleshooting/common-issues.md): Quick-reference solutions for frequently encountered NVIDIA Brev CLI, connectivity, container, and GPU issues.
- [CLI Installation (Linux)](https://docs.nvidia.com/brev/latest/troubleshooting/cli-installation/cli-installation-linux.md): Resolve silent installation failures when installing the NVIDIA Brev CLI on Linux systems.
- [CLI Install Fails with GitHub Rate Limit](https://docs.nvidia.com/brev/latest/troubleshooting/cli-installation/github-rate-limit.md): Resolve NVIDIA Brev CLI install script failures caused by GitHub API rate limits on shared egress or VPN IP addresses.
- [CLI SSH Authentication (macOS)](https://docs.nvidia.com/brev/latest/troubleshooting/cli-installation/cli-ssh-authentication-macos.md): Resolve Brev CLI SSH authentication failures caused by invalid or corrupted SSH keys on macOS.
- [Instance Stuck in Waiting State](https://docs.nvidia.com/brev/latest/troubleshooting/instances-gpus/instance-stuck-in-waiting-state.md): Diagnose and resolve NVIDIA Brev instances that remain indefinitely in "Waiting" state during provisioning.
- [GPU Detection and PyTorch Setup](https://docs.nvidia.com/brev/latest/troubleshooting/instances-gpus/gpu-detection-pytorch.md): Resolve GPU detection issues with PyTorch, CUDA, and Unsloth on H100 instances.
- [VS Code Connection (Windows/WSL)](https://docs.nvidia.com/brev/latest/troubleshooting/ide-connectivity/vscode-windows-wsl.md): Configure VS Code Remote SSH to work with NVIDIA Brev Cloudflare Tunnel on Windows with WSL.