Skip to content
benbrookshire edited this page Feb 5, 2021 · 2 revisions

Introduction about the supported protocols

This is an incomplete list of the services supported by ddclient. If your favourite dynamic dns provider isn't here, check the result ddclient --help with the most recent version of ddclient. If it's there, check the patches section on sf.net and if it's really not supported by ddclient you can try to modify ddclient yourself.

Since ddclient version 3.7, ddclient also supports https to update your favourite provider. Use the ssl=yes option to use this feature.

dnspark protocol

The 'dnspark' protocol is used by DNS service offered by www.dnspark.com.

Configuration variables applicable to the 'dsnpark' protocol are:

configuration information
protocol=dnspark
server=fqdn.of.service defaults to www.dnspark.com
backupmx=no indicates that DNSPark should be the secondary MX for this domain or host.
mx=any.host.domain a host MX'ing for this host or domain.
mxpri=priority MX priority.
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=dnspark,                                         \
login=my-dnspark.com-login,                               \
password=my-dnspark.com-password                          \
myhost.dnspark.com

## multiple host update with wildcard'ing mx, and backupmx
protocol=dnspark,                                         \
login=my-dnspark.com-login,                               \
password=my-dnspark.com-password,                         \
mx=a.host.willing.to.mx.for.me,                           \
mxpri=10,                                                 \
my-toplevel-domain.com,my-other-domain.com

## multiple host update to the custom DNS service
protocol=dnspark,                                         \
login=my-dnspark.com-login,                               \
password=my-dnspark.com-password                          \
my-toplevel-domain.com,my-other-domain.com

dslreports

The 'dslreports1' protocol is used by a free DSL monitoring service offered by www.dslreports.com.

Configuration variables applicable to the 'dslreports1' protocol are: br

configuration information
protocol=dslreports1
server=fqdn.of.service defaults to www.dslreports.com
login=service-login login name and password registered with the service
password=service-password
unique-number the host registered with the service.

Example ddclient.conf file entries:

## single host update
protocol=dslreports1,                                     \
server=www.dslreports.com,                                \
login=my-dslreports-login,                                \
password=my-dslreports-password                           \
123456

Note: DSL Reports uses a unique number as the host name. This number can be found on the Monitor Control web page.

dyndns1

The 'dyndns1' protocol is a deprecated protocol used by the free dynamic DNS service offered by www.dyndns.com. The 'dyndns2' should be used to update the www.dyndns.com service. However, other services are also using this protocol so support is still provided by ddclient.

Configuration variables applicable to the 'dyndns1' protocol are:

configuration information
protocol=dyndns1
server=fqdn.of.service defaults to members.dyndns.org
backupmx=no indicates that this host is the primary MX for the domain. Set to yes to mark it as a backup mx.
mx=any.host.domain a host MX'ing for this host definition.
wildcard=yes add a DNS wildcard CNAME record that points to {host}. Set to no if you don't need a wildcard.
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=dyndns1,                                         \
login=my-dyndns.org-login,                                \
password=my-dyndns.org-password                           \
myhost.dyndns.org

## multiple host update with wildcard'ing mx, and backupmx
protocol=dyndns1,                                         \
login=my-dyndns.org-login,                                \
password=my-dyndns.org-password,                          \
mx=a.host.willing.to.mx.for.me,backupmx=yes,wildcard=yes  \
myhost.dyndns.org,my2ndhost.dyndns.org

Note: you only need one of the examples

dyndns2

The 'dyndns2' protocol is a newer low-bandwidth protocol used by a free dynamic DNS service offered by www.dyndns.com. It supports features of the older 'dyndns1' in addition to others.

Configuration variables applicable to the 'dyndns2' protocol are:

configuration information
protocol=dyndns2
server=fqdn.of.service defaults to members.dyndns.org
backupmx=no indicates that this host is the primary MX for the domain.
static=no indicates that this host has a static IP address.
custom=no indicates that this host is a 'custom' top-level domain name.
mx=any.host.domain a host MX'ing for this host definition.
wildcard=no add a DNS wildcard CNAME record that points to {host}
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=dyndns2,                                         \
login=my-dyndns.org-login,                                \
password=my-dyndns.org-password                           \
myhost.dyndns.org

## multiple host update with wildcard'ing mx, and backupmx
protocol=dyndns2,                                         \
login=my-dyndns.org-login,                                \
password=my-dyndns.org-password,                          \
mx=a.host.willing.to.mx.for.me,backupmx=yes,wildcard=yes  \
myhost.dyndns.org,my2ndhost.dyndns.org

## multiple host update to the custom DNS service
protocol=dyndns2,                                         \
login=my-dyndns.org-login,                                \
password=my-dyndns.org-password                           \
my-toplevel-domain.com,my-other-domain.com

'''Note:''' you only need one of the examples

easydns

The 'easydns' protocol is used by the for fee DNS service offered by www.easydns.com.

Configuration variables applicable to the 'easydns' protocol are:

configuration information
protocol=easydns
server=fqdn.of.service defaults to members.easydns.com
backupmx=no yes
mx=any.host.domain a host MX'ing for this host or domain.
wildcard=no add a DNS wildcard CNAME record that points to {host}
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=easydns,                                         \
login=my-easydns.com-login,                               \
password=my-easydns.com-password                          \
myhost.easydns.com

## multiple host update with wildcard'ing mx, and backupmx
protocol=easydns,                                         \
login=my-easydns.com-login,                               \
password=my-easydns.com-password,                         \
mx=a.host.willing.to.mx.for.me,                           \
backupmx=yes,                                             \
wildcard=yes                                              \
my-toplevel-domain.com,my-other-domain.com

## multiple host update to the custom DNS service
protocol=easydns,                                         \
login=my-easydns.com-login,                               \
password=my-easydns.com-password                          \
my-toplevel-domain.com,my-other-domain.com

googledomains

The 'googledomains' protocol is used by DNS service offered by domains.google.com.

configuration information
protocol= googledomains
use=web configure ddclient to use perform your public IP lookup on the public internet via web request
web=url url ddclient will check to lookup public IP via web request
login=service-login login name generated in Synthetic DNS record, ref https://support.google.com/domains/answer/6147083
password=service-password login password generated in Synthetic DNS record, ref https://support.google.com/domains/answer/6147083
fully.qualified.host the host registered with the service

Note: to update a root domain, ensure your Google Domains synthetic record is configured using @, reference above Synthetic Record documentation.

Example ddclient.conf file entries:

use=web
web=https://domains.google.com/checkip
protocol=googledomains
ssl=yes

login=yourloginusername
password=yourpassword

fully.qualified.host

namecheap

The 'namecheap' protocol is used by DNS service offered by www.namecheap.com.

Configuration variables applicable to the 'easydns' protocol are:

configuration information
protocol=namecheap
server=fqdn.of.service defaults to dynamicdns.park-your-domain.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=namecheap,                                         \
login=my-namecheap.com-login,                               \
password=my-namecheap.com-password                          \
myhost.namecheap.com

zoneedit1

The 'zoneedit1' protocol is used by a DNS service offered by www.zoneedit.com.

Configuration variables applicable to the 'zoneedit1' protocol are:

configuration information
protocol=zoneedit1
server=fqdn.of.service defaults to www.zoneedit.com
login=service-login login name and password registered with the service
password=service-password
your.domain.name the host registered with the service.

Example ddclient.conf file entries:

## single host update
protocol=zoneedit1,                                     \
server=www.zoneedit.com,                                \
login=my-zoneedit-login,                                \
password=my-zoneedit-password                           \
my.domain.name

## multiple host update                                 \
protocol=zoneedit1,                                     \
server=www.zoneedit.com,                                \
login=my-zoneedit-login,                                \
password=my-zoneedit-password                           \
my.domain.name,my2nd.domain.com

Changeip

The 'changeip' protocol is used by DNS services offered by changeip.com.

Configuration variables applicable to the 'changeip' protocol are:

configuration information
protocol=changeip
server=fqdn.of.service defaults to nic.changeip.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=changeip,                                               \
login=my-my-changeip.com-login,                                  \
password=my-changeip.com-password                                \
myhost.changeip.org

ChangeIP is supported since [r150] based on a patch submitted by Michele Giorato in [e85661ad]