reggae

Cross-registrar domain manager CLI — manage domains and DNS records across Porkbun, Cloudflare, GoDaddy, Namecheap and more from a single command-line tool.

Installation

curl -sSL https://raw.githubusercontent.com/trydirect/reggae/main/installer.sh | bash

Or build from source:

cargo install --path .

Quick start

# Set credentials via environment variablesexport DM_PROVIDERS_PORKBUN_API_KEY=pk1_...
export DM_PROVIDERS_PORKBUN_SECRET_API_KEY=sk1_...
# Check availability
reggae check example.com
# Register a domain with an A record
reggae register --domain example.com --A 198.51.100.1
# List DNS records
reggae dns list --domain example.com
# Add a DNS record
reggae dns add --domain example.com --record-type TXT --name @ --content "v=spf1 include:spf.example.com ~all"# Get pricing
reggae pricing com
# Get domain info
reggae info example.com

Configuration

Credentials are never passed as CLI arguments. Use environment variables (highest priority) or config.yaml.

cp config.yaml.example config.yaml
$EDITOR config.yaml

Environment variable	Config key	Description
DM_DEFAULT_PROVIDER	default_provider	Default registrar
DM_PROVIDERS_PORKBUN_API_KEY	providers.porkbun.api_key	Porkbun API key
DM_PROVIDERS_PORKBUN_SECRET_API_KEY	providers.porkbun.secret_api_key	Porkbun secret
DM_PROVIDERS_CLOUDFLARE_API_TOKEN	providers.cloudflare.api_token	Cloudflare token
DM_PROVIDERS_GODADDY_API_KEY	providers.godaddy.api_key	GoDaddy key
DM_PROVIDERS_GODADDY_API_SECRET	providers.godaddy.api_secret	GoDaddy secret
DM_PROVIDERS_GANDI_PERSONAL_ACCESS_TOKEN	providers.gandi.personal_access_token	Gandi PAT
DM_PROVIDERS_GANDI_SANDBOX	providers.gandi.sandbox	Use Gandi sandbox
DM_PROVIDERS_NAMECOM_USERNAME	providers.namecom.username	Name.com username
DM_PROVIDERS_NAMECOM_API_TOKEN	providers.namecom.api_token	Name.com API token
DM_PROVIDERS_NAMECOM_SANDBOX	providers.namecom.sandbox	Use Name.com test server
DM_PROVIDERS_DYNADOT_API_KEY	providers.dynadot.api_key	Dynadot API key
DM_PROVIDERS_DYNADOT_SANDBOX	providers.dynadot.sandbox	Use Dynadot sandbox
DM_PROVIDERS_IONOS_API_PREFIX	providers.ionos.api_prefix	IONOS key prefix
DM_PROVIDERS_IONOS_API_SECRET	providers.ionos.api_secret	IONOS key secret
DM_SCHEDULER_ENABLED	scheduler.enabled	Enable expiry daemon
DM_SCHEDULER_EXPIRY_LEAD_DAYS	scheduler.expiry_lead_days	Notify N days before expiry

Expiry notifications

# Daemon mode (runs continuously)
reggae schedule
# One-shot (use with cron or systemd timer)
reggae run-check

Add domains to monitor in config.yaml:

scheduler:
enabled: trueexpiry_lead_days: 30domains:
- example.com
- mysite.ionotification:
type: webhookwebhook_url: https://hooks.example.com/notify

Providers

Provider	Status	Auth
Porkbun	✅ Full	api_key + secret_api_key
Cloudflare	✅ Full	api_token (Bearer)
GoDaddy	✅ Full	api_key + api_secret
Namecheap	✅ Full	api_user + api_key (XML API)
Gandi	✅ Full	Personal Access Token (Bearer)
Name.com	✅ Full	username + api_token (Basic)
Dynadot	✅ Full	api_key (XML API)
IONOS	✅ DNS + domain info	api_prefix.api_secret header

Output formats

reggae dns list --domain example.com --output table # default
reggae dns list --domain example.com --output json # machine-readable

Shell completions

reggae completion bash >>~/.bashrc
reggae completion zsh >>~/.zshrc
reggae completion fish >~/.config/fish/completions/reggae.fish

Adding a provider

See src/extensions/README.md.

Development

cargo build
cargo test
cargo clippy