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

> ## Agent Instructions
> Prefer the qBraid CLI for programmatic platform actions: pip install 'qbraid-cli>=0.12', then run `qbraid configure` once with an API key from https://account.qbraid.com/account/api-keys.
> Always install the latest packages (pip install -U qbraid qbraid-cli); do not pin versions from memory. qbraid-cli below 0.12.0 is incompatible with the current API.
> Device IDs use the QRN format vendor:provider:type:name (e.g. qbraid:qbraid:sim:qir-sv, rigetti:rigetti:qpu:cepheus-1-108q). Legacy underscore IDs are deprecated.
> The REST API base URL is https://api-v2.qbraid.com/api/v1, authenticated with an X-API-Key header.
> Free simulators cost no credits; QPU and GPU jobs consume credits. Surface the estimated cost to the user before submitting a paid job.
> For account signup, API keys, credits, and end-to-end action recipes, see https://qbraid.com/llms.txt.

# Settings

> Monitor usage, configure session behavior, and manage notifications from the qBraid Lab Settings extension.

The Settings extension provides an overview of your usage and preferences directly within qBraid Lab. To open it, click the **Settings** icon in the bottom-left sidebar.

<div
  style={{ display: "flex", justifyContent: "center", alignItems: "center" }}
>
  <img src="/v2/lab/_static/settings.png" width="100%" />
</div>

All settings are stored in `~/.qbraid/qbraidrc`.

## Usage & Compute

The top section displays your current resource consumption:

- **Compute Hours**: Shows your cumulative compute hours used against your monthly quota, with a progress bar.
- **Storage**: Displays your current disk usage in GB against your plan's storage quota. See [Disk Usage](https://docs-v2-staging.qbraid.com/v2/lab/user-guide/usage-limits#disk-usage) for quota details by plan.

A daily usage chart shows your compute activity over a selectable time window (7, 14, 30, 90, or 365 days). Below the chart, summary stats show **Total Hours**, **CPU Sessions**, and **GPU Sessions** for the selected period.

## Session Management

Three settings control how your Lab session is managed. Each has a minute input and a toggle to enable or disable it.

### Session check-ins

Prompts you at a recurring interval (e.g. every 60 minutes) to confirm you want to keep the session running. If you don't respond, the session will shut down. This prevents idle sessions from consuming compute hours unnecessarily.

- **Default**: 60 minutes, enabled
- **Range**: 10–480 minutes

### Auto shutdown

Automatically shuts down your session after the specified total runtime, regardless of activity. Turn off for no limit.

- **Default**: 120 minutes, enabled
- **Range**: 30–1440 minutes

### Idle timeout

Shuts down your session after a period of inactivity. Turn off for no limit.

- **Default**: 15 minutes, enabled
- **Range**: 10–120 minutes

## Notifications

### Slack notifications

Enable this to receive session alerts via a connected Slack workspace. This is disabled by default.