Index

Name

ddns — Dynamic DNS update client

Synopsis

ddns [OPTIONS...] COMMAND

Description

ddns is a simple, extensible, cross-distribution, cross-platform dynamic DNS updater written in Python.

Options

The following options are understood:

-c CONFIG , --config CONFIG

Load the specified configuration file. (Default: /etc/ddns/ddns.conf)

For further details of the config file layout, please consult the ddns.conf(5) manual page.

-d , --debug

Enables the debugging output.

-h , --help

Shows the help message provided by the program and exit.

Commands

The following commands are understood:

update [--force] HOSTNAME

Perform an update for a single host, specified by the given hostname.

An update is only sent when it is needed: when the IP addresses have changed since the last update that has been sent, or when the provider wants to have its records refreshed. Before the first update of a host, its name is being resolved to find out whether its records are up to date.

After an update has failed, no further updates are being sent for some time, so that the provider does not block the account.

The --force switch can be used to skip those checks and perform an update. Please note that some providers may block your account if unnecessary updates are repeatedly performed.

update-all [--force]

Update all configured dynamic DNS hosts when an update is necessary. Updates for several hosts are being sent at the same time.

The --force switch has the same effect as with the update command.

guess-ip-addresses

Guesses the public IPv6 and IPv4 addresses with help of an external server and prints them on the console.

list-providers

This command will print out a list of all supported dynamic DNS providers.

list-token-providers

This command will print out a list of all providers that support authentication with a token.

Logging

ddns logs to the systemd journal if python-systemd is available, and otherwise to syslog. Messages about an update carry the hostname and the provider in the fields DDNS_HOSTNAME and DDNS_PROVIDER of the journal.

Passwords, tokens and other credentials from the configuration are never being logged, not even with --debug, so that the output can be shared in bug reports.

Exit Codes

0

Success: all records are up to date.

1

An update has failed, or has been withheld because an earlier update has failed, or there has been another error (e.g. in the configuration file).

2

The command line was invalid.

Bugs

Please report all bugs to the official bugtracker at https://bugzilla.ipfire.org/ (Product: DDNS Updater).

See Also

ddns.conf(5)