Skip to content

Update

Update domain name via DDNS services

In order to update a domain name with a DynDNS client you should register to a DDNS service first, configure the desired FQDN there and retrieve the authentication token or the update key required to authenticate to the service.

Tip

Some DynDNS providers do not provide authentication tokens or update keys: in that case the authentication token can be generated using the user and password of the service account concatenated by a colon: user:password.

To update a domain name (FQDN, type A record) to the current public IP address of the host run:

ddflare set -s <DDNS_URL> -t <AUTH_TOKEN> <FQDN>
where <DDNS_URL> is the http endpoint of the DDNS service, <FQDN> is the domain to be updated and <AUTH_TOKEN> is the Update Key or the API authentication token.

Example

Required data Sample value
DDNS provider No-IP
FQDN to update myhost.ddns.net
user 68816xj
password v4UMHzugodpE
update myhost.ddns.net at NoIP
ddflare set -s noip -t 68816xj:v4UMHzugodpE  myhost.ddns.net

Update domain name via Cloudflare

Note

To update a FQDN via Cloudflare you need to buy a domain at Cloudflare (or transfer it to).
You also need to create a Cloudflare API token with Zone.DNS Edit permission following the Cloudflare docs.

ddflare can update existing type A DNS records but cannot create new ones yet, so the record should be created in advance.
To create a type A record see Cloudflare's Manage DNS Records docs.

Tip

When creating a type A DNS record pay attention to the value of the TTL field: it tracks the number of seconds DNS clients and DNS resolvers are allowed to cache the resolved IP address. You may want to keep the TTL low (the allowed minimum is 60 secs) if you plan to use the record to track the (dynamic) IP address of a host in a DDNS scenario.

ddflare set -t <CLOUDFLARE_TOKEN> <FQDN>
where <FQDN> is the domain to be updated and <CLOUDFLARE_TOKEN> is the Cloudflare API token.

Example

Required data Sample value
FQDN to update myhost.example.com
API token gB1fOLbl2d5XynhfIOJvzX8Y4rZnU5RLPW1hg7cM
update myhost.example.com at Cloudflare
ddflare set -t gB1fOLbl2d5XynhfIOJvzX8Y4rZnU5RLPW1hg7cM  myhost.example.com