From SME Server
Jump to: navigation, search


Contrib 9:
The latest version of smeserver-ddclient is available in the SME repository, click on the version number(s) for more information.

ddclient - DNS record updating

Use this contrib when you have a sme server connected to a ISP service using a dynamic IP, and you wish to host multiple domains.

ddclient is a client for updating dynamic DNS entries for domains hosted at different DNS providers.

Configure your dynamic host domains via the ddclient server manager panel.

ddclient can be used on servers configured in server gateway mode or in server only mode.

Smecontribs repository version


Stéphane de Labrusse AKA Stephdl

This contrib is the official and maintained version for SME Server 8, some Free or paid services of dynamic dns had been incorporated to the contribs.


yum install --enablerepo=smecontribs smeserver-ddclient


signal-event ddclient


signal-event post-upgrade; signal-event reboot
yum install --enablerepo=smecontribs smeserver-ddclient


signal-event ddclient


signal-event post-upgrade; signal-event reboot

A new panel will be added to the server manager.

Use this panel to configure domain records you wish to keep updated with your dynamic IP using the ddclient contrib

How to use

First you need to create a domain in the server-manager (domains panel) which must match the domain you set with your dynamic dns provider.

For example if the domain you made at DTdns is :


You have to create a relevant domain with this name.

Then go to the panel of "Dynamic clients", choose the domain you made then set your dynamic DNS provider eg (dtdns) and associated credentials to that provider.

DB settings

  • There are some of the services that you can use to detect your external ip
  • ip.changeip.com
  • ipdetect.dnspark.com
  • checkip.dyndns.org:8245
  • checkip.dyndns.org

If you want to change the service which verifies your external ip you can do :

config setprop ddclient urlcheckip ip.changeip.com
signal-event ddclient
  • Every 300s the contrib perform a check to verify if your ip has been changed to http://checkip.dyndns.org/. you can change the interval of the deamon update by a db command (by default it is 300 seconds). It seems that the minimum accepted is 60s. Possibly you could be blacklisted by providers if you decrease the time-out under of 300s.
config setprop ddclient DeamonUpdate 60
signal-event ddclient
  • use SSL

since ddclient 3.7.0 you can encrypt transactions to avoid clear messages. by default forced to yes

config setprop ddclient SSL yes


config setprop ddclient SSL no


signal-event ddclient
  • full db ddclient
# config show ddclient  

Providers available

Here the official wiki

  • Dyndns.org
  • ZoneEdit.com
  • Easydns.com
  • Hammernode (hn.org)
  • dslreports.com
  • eurodyndns.org
  • Dtdns.com
  • loopia.se
  • dnspark.com
  • Dynhost (ovh.com)
  • Noip.com
  • Changeip.com
  • Namecheap

If your dynamic dns provider is not available in smeserver-ddclient, please raise a bug and provide the settings for your provider with ddclient (search for settings with google).


yum remove smeserver-ddclient
signal-event post-upgrade; signal-event reboot


Important.png Note:
Even with the lower value acceptable (60s) it needs between 60 to 180s to see change in dns record.

  • You can keep an eye on log
watch 'cat /var/log/messages|grep SUCCESS'
  • You can supervise dns record
watch 'dig any your_dynamic_dns_host.xxx @dns_server_of_your_dynamic_dns_provider'
  • If you want to know the dns servers of your dynamic provider, do
dig any your_dynamic_dns_host.xxx

and look about hosts in NS columns.

  • If stuff goes bad you can debug and see what is happening to the deamon
ddclient -daemon=0 -debug -verbose -noquiet

and report please

  • keep an eye on the ddclient cache
less /var/cache/ddclient/ddclient.cache


Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-ddclient component or use this link .

IDProductVersionStatusSummary (5 tasks)
10593SME Contribs9.2UNCONFIRMEDspdns.de / spdyn.de (securepoint) changed server
10363SME ContribsFuturUNCONFIRMEDAdding a new Daynamic DNS Provider - https://freedns.afraid.org/dynamic/
9450SME Contribs8.2CONFIRMEDallow alternative methods to get ip
8538SME Contribs8.1CONFIRMEDNamecheap dynamic DNS setup
8115SME Contribs8.0UNCONFIRMEDMultiple domains not updated by ddclient


Only released version in smecontrib are listed here.

smeserver-ddclient Changelog: SME 9 (smecontribs)
2017/12/02 SME Translation Server 1.2.1-9.sme
- apply locale 2017-12-02 patch
2016/03/09 JP Pialasse 1.2.1-8.sme
- apply locale 2016-03-09 patch
2015/09/12 stephane de labrusse - 1.2.1-7.sme
- Added smeserver-ddclient-1.2.1-locale-2015-09-12.patch
2015/07/11 stephane de labrusse - 1.2.1-6.sme
- Added locale smeserver-ddclient-1.2.1-locale-2015-07-11.patch

2015/07/10 stephane de labrusse - 1.2.1-5.sme
- added spdns.de [SME: 8975]
- added custom fields for dns providers [SME: 8961]

- added custom fields for free domains and panel options to ddclient [SME: 8983]

smeserver.free.fr version

Important.png Note:
This contribs is no longer maintained and may be unstable or broke your system

Warning.png Warning:
When you have the smeserver.free.fr sme7-ddclient contrib installed and you run yum upgrade with the smecontribs repository enabled on your server, watch out! There is a smeserver-ddclient package that will get installed as an upgrade and this conflicts with the sme7-ddclient package ! Remove the sme7-ddclient first, see instructions below.

Note: This RPM works with SME 8 or SME 7

The smeserver.free.fr site appears to be defunct (since at least April 2012), so this article provides a link to the contrib at another external file download site.

This contrib has some additional features like the ability to select the method on how the detect the external IP address and the ability to publish arbitrary domain names (i.e. not just the ones that are on your server).


Download the latest rpm version from


to an empty folder eg /tmp and unzip the file

unzip sme7-ddclient*

The currently available rpm is:


Then cd to that folder and install the rpm (change the rpm name in the following command to match the latest available version)

cd /tmp
yum localinstall sme7-ddclient*.rpm


yum remove sme7-ddclient
signal-event post-upgrade;signal-event reboot

Using SME default dynamic client & external DNS CNAME entries

In many cases, you really do not need to use ddclient or some variation of it eg sme7-ddclient or smeserver-ddclient

You can use the built in dynamic client for your main domain (accessible by running Configure this server from the admin console).

Then create CNAME entries in external DNS records which point at the main domain name.

SME will update the main domain name/dynamicIP change, and the additional domains will follow it as the external IP changes.

The use of this method is only possible where the full DNS records are accessible & editable by admin users.

In some situations with DNS service providers, these DNS records are not accessible, in that case you will need to use one of the ddclient methods.

Also see http://bugs.contribs.org/show_bug.cgi?id=6206#c9 which says:

"I notice that you mention two dyndns domains, but you should be able to set up domain2.x.y to be a CNAME for domain1.x.y, then configure domain1.x.y with the builtin client."