Ddclient: Difference between revisions

break down DNS Provider section for better extensibility
m grammar + wordsmithing
Line 19: Line 19:
}|name=configuration.nix|lang=nix}}
}|name=configuration.nix|lang=nix}}


{{Nixos:option|services.ddclient.interval|Interval}} 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].
{{Nixos:option|services.ddclient.interval|Interval}} may be set to a time of your choosing, check your DNS provider's documentation to ensure that you aren't sending requests too frequently. For formatting, run <code>man 7 systemd.time</code> or reference the [https://man7.org/linux/man-pages/man7/systemd.time.7.html online man pages].


=== Using Your DNS Provider ===
=== Using Your DNS Provider ===
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 {{Nixos:option|services.ddclient.protocol|protocol}}, {{Nixos:option|services.ddclient.username|username}}, {{Nixos:option|services.ddclient.passwordFile|passwordFile}}, {{Nixos:option|services.ddclient.domain|domain}}, and {{Nixos:option|services.ddclient.zone|zone}}.
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 for the name of your DNS provider in the [https://github.com/ddclient/ddclient/blob/main/ddclient.in ddclient source code]. Modify the above configuration with the relevant {{Nixos:option|services.ddclient.protocol|protocol}}, {{Nixos:option|services.ddclient.username|username}}, {{Nixos:option|services.ddclient.passwordFile|passwordFile}}, {{Nixos:option|services.ddclient.domain|domain}}, and {{Nixos:option|services.ddclient.zone|zone}} from the documentation or source code.


==== Cloudflare ====
==== Cloudflare ====
Line 32: Line 32:
    fully.qualified.host         ## the host registered with the service.|name=ddclient.in|lang=}}
    fully.qualified.host         ## the host registered with the service.|name=ddclient.in|lang=}}


This excerpt of [https://github.com/ddclient/ddclient/blob/main/ddclient.in ddclient.in] describes the specific options needed for Cloudflare. Reference the above nix configuration to understand the mapping of ddclient config to Nix config.
This excerpt of [https://github.com/ddclient/ddclient/blob/main/ddclient.in ddclient.in] describes the specific options needed for Cloudflare. Reference the above nix configuration to understand the mapping between the ddclient config and the Nix config.


== Troubleshooting ==
== Troubleshooting ==