Dynamic DNS with Cloudflare

CloudFlare is the perfect dynamic DNS host because, unlike the other major ones, CloudFlare is completely free. Unfortunately if your ISP dosen’t allow use of a static IP, maintaining regular internet uptime can be quite annoying. Using a curl / systemd based solution to check and renew my IP if it changes works well with my Ubuntu / Linux box.


  • DNS Zone: You can get it by visiting the overview page of Cloudflare dashboard (called Zone ID): https://www.cloudflare.com/a/overview/
  • Auth Email: This is your cloudflare account email.
  • Auth Key: This is your Global API Key under Cloudflare account settings: https://www.cloudflare.com/a/account/my-account/
  • IDENTIFIER: To get the identifier, you need to first set an A record for the domain or subdomain you want to manage with Dynamic DNS. Then, plug in the domain or subdomain in this curl query to obtain the identifier:
curl "https://api.cloudflare.com/client/v4/zones/<your-dns-zone>/dns_records?name=<subdomain>.<your-domain>" \
       --silent -X GET \
       -H "X-Auth-Email: <cloudflare-auth-email>" \
       -H "X-Auth-Key: <cloudflare-auth-key>" \
       -H "Content-Type: application/json" 

IP Address

I use dig with OpenDNS to get the current public IP address and https://www.ipify.org/ as a fallback if dig isn’t installed. Using dig is faster though and can be installed via dnsutils (available as an official package on most systems).

The Script

All the above information can now be plugged in this bash script to update the DNS entry on Cloudflare. I placed it at /usr/local/bin/cloudflare-ddns.sh

#/usr/bin/env sh

# Get the Zone ID from: https://www.cloudflare.com/a/overview/<your-domain>

# Get the existing identifier for DNS entry:
# https://api.cloudflare.com/#dns-records-for-a-zone-list-dns-records

# Get these from: https://www.cloudflare.com/a/account/my-account

# Desired <domain> or <subdomain>.<domain> name:

# Get previous IP address and store it
_PREV_IP=$(cat $_PREV_IP_FILE &> /dev/null)

# Install `dig` via `dnsutils` for faster IP lookup.
command -v dig &> /dev/null && {
    _IP=$(dig +short myip.opendns.com @resolver1.opendns.com)
} || {
    _IP=$(curl --silent https://api.ipify.org)
} || {
    exit 1

# If new/previous IPs match, no need for an update.
if [ "$_IP" = "$_PREV_IP" ]; then
    exit 0

_UPDATE=$(cat <<EOF
{ "type": "A",
  "name": "$DOMAIN_NAME",
  "content": "$_IP",
  "ttl": 120,
  "proxied": false }

curl "https://api.cloudflare.com/client/v4/zones/$DNS_ZONE/dns_records/$IDENTIFIER" \
     --silent \
     -X PUT \
     -H "Content-Type: application/json" \
     -H "X-Auth-Email: $AUTH_EMAIL" \
     -H "X-Auth-Key: $AUTH_KEY" \
     -d "$_UPDATE" > /tmp/cloudflare-ddns-update.json && \
     echo $_IP > $_PREV_IP_FILE

Try running cloudflare-ddns.sh to see if DNS records get updated on Cloudflare. For debugging purposes, The Cloudflare response is stored at /tmp/cloudflare-ddns-update.json.


We’ll automate this execution by writing a systemd service and a timer.

Configuring the service

My systemd service unit looks like this: /etc/systemd/system/cloudflare-ddns.service

Description=Update DNS entry for this host to current IP

ExecStart=/bin/sh /usr/local/bin/cloudflare-ddns.sh

Test the service by running:

sudo systemctl start cloudflare-ddns.service

View the results:

sudo journalctl -u cloudflare-ddns

Setting up a timer

Set up a timer, so that DNS update is attempted every 2 minutes: /etc/systemd/system/cloudflare-ddns.timer

Description=Update DNS entry in cloudflare every 2 minutes



To enable the timer, run:

sudo systemctl enable cloudflare-ddns.timer

And that’s it, now the system’s IP will be kept up to date (within 2 minutes) for remote access.