Skip to content

Domain Verification

Manage domain ownership verification.

Overview

Domain verification proves you own a domain by requiring you to add a specific TXT record to your DNS. The workflow is:

  1. Create a verification request for your domain
  2. Add the provided TXT record to your DNS
  3. Trigger the verification check
  4. Domain is marked as verified

Commands

List Domains

bnerd domains list

Lists all domains for your organization, including both verified and pending domains.

Get Domain Details

bnerd domains get <domain-id>

Create Verification Request

bnerd domains create <domain-name>

Creates a new domain verification request. The output includes instructions for the TXT record you need to add to your DNS:

Domain verification request created!

Add the following TXT record to your DNS:
  Host:  _hq-verify.example.com
  Type:  TXT
  Value: bnerd-verify=abc123...
  TTL:   300

Then run: bnerd domains verify <domain-id>

Verify Domain

bnerd domains verify <domain-id>

Triggers a DNS lookup to check if the verification TXT record exists. On success, the domain status changes to verified.

Tip

DNS propagation can take time. If verification fails, wait a few minutes and try again. Use --debug to see the actual DNS query being made.

Regenerate Verification Token

bnerd domains regenerate <domain-id>

Generates a new verification token. You'll need to update the TXT record in your DNS with the new value.

Delete Domain

bnerd domains delete <domain-id>

Deletes an unverified domain verification request.

Verification Workflow Example

# Step 1: Create verification request
bnerd domains create example.com
# Note the domain ID and TXT record details

# Step 2: Add TXT record to your DNS
bnerd dns records create <zone-id> \
  --name _hq-verify.example.com. \
  --type TXT \
  --content "bnerd-verify=abc123..."

# Step 3: Wait for DNS propagation, then verify
bnerd domains verify <domain-id>

Domain Statuses

Status Description
pending Verification request created, awaiting DNS check
verified Domain ownership confirmed
failed Verification check failed (check TXT record)

TUI Equivalent

In the interactive TUI (bnerd x), use the :domains command to manage domains.