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

# Configuration

> Profiles, global options, output formats, and environment variables.

## Profiles

The CLI supports multiple named configurations called **profiles**. Each profile stores its own API key, so you can switch between personal, staging, and production accounts.

```bash theme={null}
# Default profile
bunny login

# Named profile
bunny login --profile staging

# Run any command against a profile
bunny db list --profile staging
```

See [`bunny config`](/docs/cli/commands/config) for creating, inspecting, and deleting profiles.

## Global options

These flags are available on every command.

| Flag | Alias | Description | Default |
| - | - | - | - |
| `--profile` | `-p` | Configuration profile to use | `default` |
| `--verbose` | `-v` | Enable verbose output | `false` |
| `--output` | `-o` | Output format: `text`, `json`, `table`, `csv`, or `markdown` | `text` |
| `--api-key` | | API key (takes priority over profile and environment) | |
| `--version` | | Show version | |
| `--help` | | Show help | |

## Output formats

Use `--output` (or `-o`) to control how results are printed. This is particularly useful for scripting or piping into other tools.

| Format | Description |
| - | - |
| `text` | Human-friendly borderless tables with bold headers (default) |
| `json` | Structured JSON for scripting and piping |
| `table` | Bordered ASCII table |
| `csv` | Comma-separated values with proper escaping |
| `markdown` | GitHub-flavored pipe tables |

```bash theme={null}
bunny db list --output json
bunny db list --output csv > databases.csv
bunny db list --output markdown
```

## Environment variables

| Variable | Description |
| - | - |
| `BUNNYNET_API_KEY` | API key (overrides profile-based key) |
| `BUNNYNET_API_URL` | API base URL (default: `https://api.bunny.net`) |
| `BUNNYNET_DASHBOARD_URL` | Dashboard URL for auth flow (default: `https://dash.bunny.net`) |
| `NO_COLOR` | Disable colored output ([no-color.org](https://no-color.org)) |

### Database-specific

Some `bunny db` commands also read from a `.env` file walked up from the current directory:

| Variable | Read by |
| - | - |
| `BUNNY_DATABASE_URL` | All `db` commands. Auto-detects the target database |
| `BUNNY_DATABASE_AUTH_TOKEN` | `bunny db shell`. Skips on-demand token generation |

Both variables can be written automatically by `bunny db create --save-env` or `bunny db quickstart`.

## Shell completion

Generate a shell completion script with `bunny completion` and add the output to your shell profile to enable tab completion.

```bash theme={null}
bunny completion >> ~/.zshrc
```

## Resolving credentials

When a command needs an API key, the CLI resolves it in this order:

1. `--api-key` flag
2. `BUNNYNET_API_KEY` environment variable
3. API key stored in the selected profile (`--profile` or `default`)

If none of those are set, the command will prompt you to run `bunny login`.