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

# Environment Variables

> Configure the HoneyHive CLI with environment variables. Reference supported variables for authentication, project scope, API endpoints, and runtime behavior.

The CLI reads the following environment variables. All are optional, and each can be overridden by a root-level flag, which takes precedence over its environment variable.

## Configuration

| Variable            | Description                                                                                                              | Default                           | Override flag            |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | ------------------------ |
| `HH_API_KEY`        | API key for authenticating with HoneyHive.                                                                               | None (required)                   | `--api-key <key>`        |
| `HH_DATA_PLANE_URL` | Base URL for the Data Plane API.                                                                                         | `https://api.dp1.us.honeyhive.ai` | `--data-plane-url <url>` |
| `HH_VERBOSE`        | Set to `"true"` (case-insensitive) to log the resolved data plane URL, a masked API key, and the CLI version on startup. | `false`                           | `--verbose`              |

An empty string is treated the same as unset, so `HH_API_KEY= honeyhive ...` falls back to the default (or errors, for the required API key).

<Note>
  There is no `HONEYHIVE_*` prefix in the CLI. Unlike the Python SDK, only the `HH_*` names above are recognized.
</Note>