Documentation Index
Fetch the complete documentation index at: https://docs.bunny.net/llms.txt
Use this file to discover all available pages before exploring further.
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.
# Default profile
bunny login
# Named profile
bunny login --profile staging
# Run any command against a profile
bunny db list --profile staging
See bunny 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 | |
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 |
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) |
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.
Resolving credentials
When a command needs an API key, the CLI resolves it in this order:
--api-key flag
BUNNYNET_API_KEY environment variable
- 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.