Skip to main content

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.
FlagAliasDescriptionDefault
--profile-pConfiguration profile to usedefault
--verbose-vEnable verbose outputfalse
--output-oOutput format: text, json, table, csv, or markdowntext
--api-keyAPI key (takes priority over profile and environment)
--versionShow version
--helpShow help

Output formats

Use --output (or -o) to control how results are printed. This is particularly useful for scripting or piping into other tools.
FormatDescription
textHuman-friendly borderless tables with bold headers (default)
jsonStructured JSON for scripting and piping
tableBordered ASCII table
csvComma-separated values with proper escaping
markdownGitHub-flavored pipe tables
bunny db list --output json
bunny db list --output csv > databases.csv
bunny db list --output markdown

Environment variables

VariableDescription
BUNNYNET_API_KEYAPI key (overrides profile-based key)
BUNNYNET_API_URLAPI base URL (default: https://api.bunny.net)
BUNNYNET_DASHBOARD_URLDashboard URL for auth flow (default: https://dash.bunny.net)
NO_COLORDisable colored output (no-color.org)

Database-specific

Some bunny db commands also read from a .env file walked up from the current directory:
VariableRead by
BUNNY_DATABASE_URLAll db commands. Auto-detects the target database
BUNNY_DATABASE_AUTH_TOKENbunny 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:
  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.