Ddclient: Difference between revisions

m switch to using templates instead of code blocks
break down DNS Provider section for better extensibility
 
(2 intermediate revisions by the same user not shown)
Line 19: Line 19:
}|name=configuration.nix|lang=nix}}
}|name=configuration.nix|lang=nix}}


{{Nix:option|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 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].


=== 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 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}}.
 
As an example, look for a section like the below for your provider to define the necessary attributes.


==== Cloudflare ====
{{File|3=Configuration variables applicable to the 'cloudflare' protocol are:
{{File|3=Configuration variables applicable to the 'cloudflare' protocol are:
    protocol=cloudflare          ##
    protocol=cloudflare          ##
Line 33: 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 will describe the specific options needed for your DNS provider.
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.


== Troubleshooting ==
== Troubleshooting ==
Line 42: Line 41:
# [https://github.com/ddclient/ddclient ddclient source code]
# [https://github.com/ddclient/ddclient ddclient source code]
# [https://ddclient.net/ ddclient documentation]
# [https://ddclient.net/ ddclient documentation]
[[Category:Server]]