raindrop dns

Please note you need to have your own DNS provider to use this command. For example you need to own example.com to create a DNS zone for it.

The raindrop dns command manages DNS zones and records for your domains. Create DNS zones for your domains, then add and configure DNS records (A, AAAA, CNAME, MX, TXT, etc.) to route traffic to your applications.

DNS zones are organization-scoped resources. All authenticated users in an organization can view and manage the organization’s DNS zones.

Basic Usage

Create a DNS zone:

raindrop dns create example.com

List all DNS zones:

raindrop dns list

Zone Management

raindrop dns create

Create a new DNS zone for a domain.

Syntax:

raindrop dns create <domain> [--output <format>]

Arguments:

• <domain> - Fully qualified domain name (required)

Flags:

Flag	Description	Values	Default
-o, --output	Output format	text, json	text

Examples:

# Create DNS zone
raindrop dns create example.com

# Create with JSON output
raindrop dns create example.com --output json

Output:

✅ DNS zone created successfully!

Domain: example.com
Status: active
Type: full

Nameservers:
  - ns1.liquidmetal.run
  - ns2.liquidmetal.run

📝 Update your domain registrar to use these nameservers.

Create a partial DNS zone.

raindrop dns create example.com --type=partial

Output:

Creating DNS zone for example.com...

✅ DNS zone created successfully!

Domain: example.com
Status: pending
Type: custom

---

raindrop dns delete

Delete a DNS zone and all its records.

Syntax:

raindrop dns delete <domain> [--force]

Arguments:

• <domain> - Domain name to delete (required)

Flags:

Flag	Description	Default
-f, --force	Skip confirmation prompt	false

Examples:

# Delete with confirmation
raindrop dns delete example.com

# Delete without confirmation
raindrop dns delete example.com --force

---

raindrop dns get

Get details for a specific DNS zone.

Syntax:

raindrop dns get <domain> [--output <format>]

Arguments:

• <domain> - Domain name (required)

Flags:

Flag	Description	Values	Default
-o, --output	Output format	text, json, table	text

Examples:

# Get zone details
raindrop dns get example.com

# Get as JSON
raindrop dns get example.com --output json

Output: Please note the Verification Key will correspond to the txt record created in your DNS provider.

raindrop dns get example.com

DNS Zone: example.com

Status: pending
Type: custom

Verification Key:
  <VERIFICATION_KEY> // Verification via your txt record

Timestamps:
  Created: <DATETIME>
  Updated: <DATETIME>

---

raindrop dns list

List all DNS zones in your organization.

Syntax:

raindrop dns list [--output <format>]

Flags:

Flag	Description	Values	Default
-o, --output	Output format	text, json, table	table

Examples:

# List zones in table format
raindrop dns list

# List as JSON
raindrop dns list --output json

Output:

┌─────────────┬────────┬──────┬─────────────────────┐
│ Domain      │ Status │ Type │ Nameservers         │
├─────────────┼────────┼──────┼─────────────────────┤
│ example.com │ active │ full │ ns1.liquidmetal.run │
│             │        │      │ ns2.liquidmetal.run │
└─────────────┴────────┴──────┴─────────────────────┘

Common Workflows

Setting Up a New Domain

Configure DNS for a new domain:

# Create DNS zone
raindrop dns create example.com

# Update nameservers at your registrar to those shown in output
# (ns1.liquidmetal.run, ns2.liquidmetal.run)


## Exit Codes

| Code | Description |
|------|-------------|
| 0 | Command completed successfully |
| 1 | General error (invalid domain, zone not found, etc.) |
| 2 | Invalid arguments |