ddns.conf — Configuration file for the DDNS update client


The ddns.conf file is the main configuration file of the ddns update client. This file specifies runtime configuration parameters for the programm and contains configurations for dynamic host entries that are managed by ddns.

The syntax of the configuration file is based on the INI configuration file format. Lines starting with hash (#) or semi-colon (;) are ignored.


The following options can be configured:

proxy = http://IP:PORT

This option will configure the HTTP proxy server that is used to communicate with the providers HTTP APIs.

The proxy only can be contacted by using the HTTP protocol. The server has to be specified by using its IP address and port. For example: proxy =

guess_external_ip = [true|false]

Determine the public IP addresses by using external servers.

By default, this option is disabled and automatically enabled if the client has only IP addresses defined in RFC1918 or other reserved address space.

Provider Configuration

The DDNS client supports the configuration of an unlimited amount of entries for different providers. Each entry has to be configured as an own section named by the FQDN (Fully Qualified Domain Name) inside squared brackets.


The FQDN of the dynamic host. This name will be resolved by ddns and therfore must not be a handle or something other than a FQDN.

handle =

The provider which is responsible for this host.

A list of all supported providers can be looked up by running ddns list-providers.

username = user

The username to authenticate against the provider's update service.

In most cases this will be the same username which can be used to login on your provider's web page.

password = password

The choosen password for the specified username.

token = token

An authentication token.

If your dynamic DNS provider supports token-based authentication, this method should be prefered. You do not need to specify the username if token-based authentication is used.


Example 1. For providers which use username and password for client authentication

handle =
username = username
password = password

Example 2. For providers which supports token-based authentication

handle =
token = token


Please report all bugs to the official bugtracker at

See Also