Skip to content

Quick Start

Get up and running with bnerd in 5 minutes.

Step 1: Install

See Installation for all options. The fastest way:

go install git.bnerd.net/cloud/app/cli@latest

Step 2: Initialize Configuration

bnerd config init

This creates ~/.bnerd.yaml with default settings.

Step 3: Authenticate

The easiest way to set up authentication:

bnerd login

Follow the interactive prompts to enter your API URL, credentials, and select your organization.

Alternatively, configure manually:

bnerd config set api-url https://api.bnerd.net
bnerd config set token YOUR_TOKEN
bnerd config set org-id YOUR_ORG_ID

Step 4: Verify Setup

# Check your configuration
bnerd config show

# Verify authentication
bnerd whoami

Step 5: Explore

# List your DNS zones
bnerd dns zones list

# List your domains
bnerd domains list

# Check billing
bnerd billing overview

# Launch the interactive TUI
bnerd x

What's Next?