Search:  
Gentoo Wiki

Ddclient

Merge-arrows.gifIt has been suggested that this article be Merged into one article with Dynamic DNS.    (Discuss)

Dynamic DNS is a means by which you can access your home PC (which has a dynamic IP address) using a Domain Name. In other words, you might already remotely log in to your box from work by typing ssh -l username 64.222.222.222, however, were you to use Dynamic DNS, you could access your box like so: ssh -l username mydomain.freedns.org.

ddclient is a piece of software that communicates with hosting services such as DynDNS.org (where you can register freely for up to 3 domain names) to update the resolution of the name when your IP address changes (every few weeks on most cable/dsl systems, and every time on dial-up).

Code: Installing ddclient
 emerge ddclient
 cp /etc/ddclient/sample-etc_ddclient.conf /etc/ddclient/ddclient.conf
 nano -w /etc/ddclient/ddclient.conf
 rc-update add ddclient default
 /etc/init.d/ddclient start

Here is an example configuration using the DynDNS.org service.

File: /etc/ddclient/ddclient.conf
daemon=600				# check every 600 seconds
syslog=yes				# log update msgs to syslog
#mail=root				# not neccessary
mail-failure=root			# mail failed update msgs to root
#pid=/var/run/ddclient.pid		# record PID in file.
 
use=web, web=checkip.dyndns.com/, web-skip='IP Address' # found after IP Address
 
login=CoolAJ86				# default login
password=secret				# default password
#mx=mx.for.your.host		        # default MX
#backupmx=yes|no			# host is primary MX?
wildcard=yes				# add wildcard CNAME? 
 
server=members.dyndns.org,	\
protocol=dyndns2			\
coolaj86.homedns.org

To guarantee success, you may wish to use DynDNS.org's automatic config generator. This of course requires you to have an account with DynDNS.org.


To enable ddclient to operate, but also set a minimum amount of security on the ddclient.conf file (it's a plain text file with you ddclient password in it), you may wish to run:

Code: ddclient.conf security
chmod 640 /etc/ddclient/ddclient.conf
chown root:ddclient /etc/ddclient/ddclient.conf

If you have a firewall port 80 should be allowed out for this service to work. If you don't have a firewall get one!

Code: Firewall Rule
 iptables -I OUTPUT -i eth0 -p tcp  --dport 80 -j ACCEPT

This section is a template, meant to be as simple and generic as possible.

View more detailed information or add information here Dynamic DNS.

External links

Retrieved from "http://www.gentoo-wiki.info/Ddclient"

Last modified: Thu, 02 Oct 2008 22:16:00 +0000 Hits: 13,028