| 1 | | [[PageOutline]] |
| 2 | | |
| 3 | | = Introduction = |
| 4 | | |
| 5 | | DDclient is a Perl client used to update dynamic DNS entries for accounts on Dynamic DNS Network Services' free DNS service. It was originally written by Paul Burry and is now maintained by [http://sourceforge.net/project/memberlist.php?group_id=116817 developers for ddclient on sourceforge]. It has the capability to update more than just [http://www.dyndns.com dyndns] and it can fetch your WAN-ipaddress in a few different ways. Check the configuration pages to find how to do this. |
| 6 | | |
| 7 | | According to [http://linux.cudeso.be/ cudeso.be]: [[br]] |
| 8 | | DDclient is a small but full featured client requiring only Perl and no additional modules. It runs under most UNIX OSes and has been tested under GNU/Linux and FreeBSD. Supported features include: operating as a daemon, manual and automatic updates, static and dynamic updates, optimized updates for multiple addresses, MX, wildcards, abuse avoidance, retrying failed updates, and sending update status to syslog and through e-mail. |
| 9 | | |
| 10 | | = News = |
| 11 | | [https://sourceforge.net/news/?id=301973&group_id=116817 Ddclient 3.8.1 is finally released] [[br]] |
| 12 | | [https://sourceforge.net/news/?id=291691&group_id=116817 Preparing for a new release] [[br]] |
| 13 | | [https://sourceforge.net/news/?id=274333&group_id=116817 Ddclient website moved to trac] [[br]] |
| 14 | | [https://sourceforge.net/news/?id=259495&group_id=116817 Ddclient 3.8.0 is released] [[br]] |
| 15 | | The old news can be found on [https://sourceforge.net/news/?group_id=116817 the news page] |
| 16 | | |
| 17 | | = Download = |
| 18 | | == Installation == |
| 19 | | Most distributions have a recent version of ddclient. Use it unless you really need the latest version. |
| 20 | | Ddclient doesn't have an automatic installation procedure. Get the tar-file from [http://sourceforge.net/project/showfiles.php?group_id=116817 sourceforge] and untar it. Copy the perl script to your favorite location (ex. /usr/sbin) and create a /etc/ddclient/ddclient.conf configuration file. Don't forget to create the cache directory. [[br]] |
| 21 | | If you want the bleeding edge of ddclient, you can access the latest version using; |
| 22 | | {{{ |
| 23 | | svn co https://ddclient.svn.sourceforge.net/svnroot/ddclient/trunk ddclient |
| 24 | | }}} |
| 25 | | == Configuration == |
| 26 | | There are a few configuration examples provided which you can copy to /etc/ddclient/ddclient.conf and modify. More info about the configuration can be found on the [wiki:Usage usage page][http://ddclient.sourceforge.net/?page=1%7C%5D%5D. .] There's also a sample configuration delivered with ddclient. |
| 27 | | |
| 28 | | A typical configuration like: |
| 29 | | {{{ |
| 30 | | # /etc/ddclient/ddclient.conf |
| 31 | | # |
| 32 | | protocol=dyndns2 |
| 33 | | use=web |
| 34 | | login=mylogin |
| 35 | | password=mypassword |
| 36 | | myhost.dyndns.org |
| 37 | | }}} |
| 38 | | You can run ddclient as "/usr/sbin/ddclient -daemon 300 -syslog" and put it in your startup scripts. There are samples of startup scripts provided with ddclient. |
| 39 | | |
| 40 | | == Upgrade == |
| 41 | | Replace the ddclient file by the one from the package, read the release notes and modify the cache file |
| 42 | | |
| 43 | | = Documentation = |
| 44 | | |
| 45 | | The documentation about the configuration has been split into three sections. The [wiki:Usage usage page] describes the most parts of the configuration while the [wiki:Protocols supported protocols] page describes the protocol-specific options. If you want to know how to use ddclient with your router, check the [wiki:Routers supported routers]. |
| 46 | | |
| 47 | | Debugging ddclient looks pretty hard but it isn't. First try to put as less as necessary in your configuration. Try to run {{{`}}}./ddclient -daemon=0 -noquiet -debug{{{`}}} and check the result. Try to add the features you need and check it again. Once you're happy with the result, run it as a daemon. |
| 48 | | |
| 49 | | If this doesn't work for you, there are a few places where you can look for help. If you need any help in configuring ddclient, you could try ddclient --help. It should give you all the possible configuration options so. |
| 50 | | |
| 51 | | If you think your configuration is correct, but ddclient doesn't work as you expected, you can enable debug and verbose messages by running ddclient -daemon=0 -debug -verbose -noquiet. |
| 52 | | |
| 53 | | I know the manual is not very clear, you have to read the example configurations included in the tar-file or you can run "ddclient --help" to get more help. |
| 54 | | |
| 55 | | More info about the ddclient project can be found on [http://sourceforge.net/projects/ddclient/ the ddclient project page on sourceforge] |
| 56 | | |
| 57 | | = Help and bugreporting = |
| 58 | | If you need extra help, have any bug to report, an enhancement to submit or a feature request, you can [/newticket create a new ticket]. Please only post bugs against the latest version of ddclient. The old tracking system can be found on the project page. |
| 59 | | |
| | 1 | [[Include(source:wiki/wikistart.wiki)]] |
