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:
- Create a verification request for your domain
- Add the provided TXT record to your DNS
- Trigger the verification check
- Domain is marked as verified
Commands¶
List Domains¶
Lists all domains for your organization, including both verified and pending domains.
Get Domain Details¶
Create Verification Request¶
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¶
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¶
Generates a new verification token. You'll need to update the TXT record in your DNS with the new value.
Delete Domain¶
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.