> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qbraid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# qbraid troubleshoot

> Diagnose qBraid platform issues.

Diagnose and troubleshoot qBraid platform issues.
Runs automated checks on authentication, configuration,
network connectivity, JupyterLab integration, environments,
and system compatibility.

Use this when you want to:
• Debug authentication or connectivity issues
• Verify JupyterLab extension setup
• Check environment health
• Generate a bug report for support

**Usage**:

```console theme={null}
$ qbraid troubleshoot [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--auth`: Run authentication checks only
* `--config`: Run configuration checks only
* `--network`: Run network checks only
* `--jlab`: Run JupyterLab checks only
* `--envs`: Run environment checks only
* `--system`: Run system checks only
* `-v, --verbose`: Show detailed output including per-environment checks
* `--export`: Export diagnostic report as JSON
* `--report`: Open a GitHub issue with diagnostic results
* `--help`: Show this message and exit.