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 = http://192.168.180.1:800
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.
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.
The provider which is responsible for this host.
A list of all supported providers can be looked up by running ddns list-providers.
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.
The choosen password for the specified username.
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.