***

title: Troubleshooting
description: >-
Diagnose and resolve common issues with NVIDIA Brev CLI, connectivity, GPU
detection, and instance management.
-----------------------------------

Find solutions to common issues with NVIDIA Brev. Start with the quick-reference guide for frequently encountered problems, or navigate to detailed guides for specific scenarios.

<CardGroup cols={2}>
  <Card title="Common Issues" icon="list-check" href="/troubleshooting/common-issues">
    Quick-reference solutions for CLI, connectivity, container, and GPU issues.
  </Card>

  <Card title="CLI SSH Authentication (macOS)" icon="key" href="/troubleshooting/cli-installation/cli-ssh-authentication-macos">
    Resolve SSH key authentication failures on macOS systems.
  </Card>

  <Card title="Instance Stuck in Waiting State" icon="clock" href="/troubleshooting/instances-gpus/instance-stuck-in-waiting-state">
    Diagnose and resolve instances that fail to provision.
  </Card>

  <Card title="GPU Detection and PyTorch Setup" icon="microchip" href="/troubleshooting/instances-gpus/gpu-detection-pytorch">
    Fix GPU detection issues with PyTorch, CUDA, and Unsloth on H100 instances.
  </Card>

  <Card title="VS Code Connection (Windows/WSL)" icon="window" href="/troubleshooting/ide-connectivity/vscode-windows-wsl">
    Configure VS Code Remote SSH to work with Cloudflare Tunnel on Windows.
  </Card>

  <Card title="CLI Installation (Linux)" icon="terminal" href="/troubleshooting/cli-installation/cli-installation-linux">
    Resolve silent installation failures on Linux systems.
  </Card>
</CardGroup>

## Getting Help

If you cannot resolve your issue using these guides, contact support at [brev-support@nvidia.com](mailto:brev-support@nvidia.com) with:

* Your instance name and ID
* The commands you ran
* Any error messages
* Output from `brev ls` and relevant logs