Ddclient: Difference between revisions

services.ddclient = {

  enable = true;

  interval = "5min";

  protocol = "cloudflare";

  username = "token";

  passwordFile = "/path/to/api.key";

  domains = [ "example.com" ];

  zone = "example.com";

  ssl = true;

};

<code>Interval</code> may be set to a time of your choosing, check your DNS provider's documentation to ensure that you aren't sending requests too often. For formatting run <code>man 7 systemd.time</code> or checkout the [https://man7.org/linux/man-pages/man7/systemd.time.7.html online man pages].

For more in depth info on using ddclient for a specific DNS provider visit the [https://ddclient.net/protocols.html ddclient documentation]. If your provider isn't listed there try searching the [https://github.com/ddclient/ddclient/blob/main/ddclient.in ddclient source code] for your DNS name, modifying the above configuration with the relevant <code>protocol</code>, <code>username</code>, <code>passwordFile</code>, <code>domain</code>, and <code>zone</code>.

Configuration variables applicable to the 'cloudflare' protocol are:

    fully.qualified.host         ## the host registered with the service.

This will describe any specific changes needed for your DNS provider.

Adding <code>verbose = true;</code> to your ddclient config will enable debug logs on the [[systemd]] unit, the debug logs can help verify that the client is running and able to reach your DNS provider even if it doesn't need to change the DNS records at the moment.