rr CLI – RealtimeRegister Domain Management

CLI for RealtimeRegister domain registrar. Manage domains, DNS, contacts, and processes.

When to Use

• Check domain availability (single or bulk)
• Register, renew, transfer, or delete domains
• Manage DNS zones and records
• Create/update WHOIS contacts
• Monitor async processes (registrations, transfers)
• Check account status and expiring domains

Prerequisites

# Install
brew install dedene/tap/rr

# Authenticate (stores in keyring)
rr auth login

# Or use environment variable
export RR_API_KEY=your-api-key

# Set customer handle (required for contacts)
rr config set customer mycustomer

Pagination

All list commands return max 50 results by default. Use --limit and --offset to paginate:

rr domain list --limit 100              # First 100
rr domain list --limit 100 --offset 100 # Next 100

Loop to get all results:

offset=0; while true; do
  batch=$(rr domain list --limit 100 --offset $offset --json)
  [ "$(echo "$batch" | jq length)" -eq 0 ] && break
  echo "$batch" | jq -r '.[].domainName'
  offset=$((offset + 100))
done

Output Formats

Always use --json for parsing. TSV (--plain) for simple scripting.

rr domain list          # Table (human-readable)
rr domain list --json   # JSON (for parsing)
rr domain list --plain  # TSV (tab-separated)

Command Quick Reference

Domains

Contacts

DNS Zones

Other

Common Workflows

Check and Register Domain

rr domain check example.com --json
rr domain register example.com --registrant mycontact --period 1 -y

Bulk Availability Check

rr domain check-bulk domain1.com domain2.net domain3.io --json

Create Contact First

rr contact create myhandle \
  --name "John Doe" --email john@example.com \
  --phone "+1.5551234567" --country US

DNS Zone Management

ZONE_ID=$(rr zone list --json | jq -r '.[] | select(.name=="example.com") | .id')
rr zone record add $ZONE_ID --type A --name www --content 1.2.3.4 --ttl 3600

Monitor Expiring Domains

rr domain list --expiring-within 30 --json | jq '.[].domainName'

Parsing JSON Output

# Get all domain names
rr domain list --json | jq -r '.[].domainName'

# Check if available
rr domain check example.com --json | jq -r '.available'

# Filter by status
rr domain list --json | jq '.[] | select(.status=="active")'

Error Handling

Common fixes:

• not authenticated → rr auth login
• customer not configured → rr config set customer <handle>
• rate limited → Wait and retry, or use bulk endpoints

Environment Variables

Scripting Tips

# Skip confirmation prompts
rr domain delete example.com -y

Installation

brew install dedene/tap/rr