← CLI Docs

Quick Start

Go from zero to a working DNS zone in 5 minutes.

1

Install and authenticate

pip install onedns
onedns login

Get your API key at Settings → API Keys.

2

List your zones

onedns zones list
ID   NAME              PROVIDER      STATUS   RECORDS
---  ----------------  ------------  -------  -------
12   example.com       cloudflare    active   8
13   myapp.io          dnsscienced   active   4
3

Add a DNS record

# Create an A record
onedns records create example.com --type A --name @ --content 203.0.113.10

# Create a CNAME
onedns records create example.com --type CNAME --name www --content example.com

# Create an MX record
onedns records create example.com --type MX --name @ --content mail.example.com --priority 10
4

List records

onedns records list example.com

# Filter by type
onedns records list example.com --type MX
5

Upsert records (set)

The set command creates a record if it doesn't exist, or updates it if it does. Great for automation and CI/CD.

# Point root to new IP — creates or updates
onedns records set example.com --type A --name @ --content 203.0.113.99

# Update deploy target CNAME idempotently
onedns records set myapp.io --type CNAME --name api --content api-v2.myapp.io
6

Verify delegation

onedns zones verify example.com

Confirms nameserver delegation is pointing to OneDNS.

What's next