# Cloudflare DNS (ddclient)

## Cloudflare API Requirements

{% hint style="info" %}
Cloudflare now requires ddclient version 3.9.1 or higher due to a change to APIv4. \
Debian/Ubuntu packages are currently behind at 3.8.x (As of 2020.08.06) 
{% endhint %}

**See :** [Installing Latest ddclient](https://strangebutohwell.gitbook.io/knowledge/linux/applications/ddclient/installing-latest-ddclient).

## ddclient.conf

```bash
The 'cloudflare' protocol is used by DNS service offered by www.cloudflare.com.

Configuration variables applicable to the 'cloudflare' protocol are:
  protocol=cloudflare          ##
  server=fqdn.of.service       ## defaults to www.cloudflare.com
  login=service-login          ## login name and password  registered with the service
  password=service-password    ##
  fully.qualified.host         ## the host registered with the service.

Example ddclient.conf file entries:
  ## single host update
  protocol=cloudflare,                                         \
  zone=dns.zone,                                               \
  login=my-cloudflare.com-login,                               \
  password=my-cloudflare.com-secure-token                      \
  myhost.com

  ## multiple host update to the custom DNS service
  protocol=cloudflare,                                         \
  zone=dns.zone,                                               \
  login=my-cloudflare.com-login,                               \
  password=my-cloudflare.com-secure-token                      \
  my-toplevel-domain.com,my-other-domain.com
  
```