Gentoo Wiki


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, however, were you to use Dynamic DNS, you could access your box like so: ssh -l username

ddclient is a piece of software that communicates with hosting services such as (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 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/		# record PID in file.
use=web,, web-skip='IP Address' # found after IP Address
login=CoolAJ86				# default login
password=secret				# default password		        # default MX
#backupmx=yes|no			# host is primary MX?
wildcard=yes				# add wildcard CNAME?,	\
protocol=dyndns2			\

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

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 ""

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