/gandi.net-dns-dynamic

Use a Gandi.Net subdomain you own as a replacement for a DynDNS host.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

gandi.net-dns-dynamic

Use a Gandi.Net subdomain you own as a replacement for a DynDNS host.

What Does This Do?

  • Every hour (by default), it will run a script.
  • That script will determine your externally-facing IPv4 and/or IPv6 address.
  • It will create or update A or AAAA records for a subdomain under a domain you have registered at Gandi.Net.

Why Does This Do?

I got a renewal notice for DynDNS.com and noticed that the cost had shot up precipitously. I thought there had to be a better way. I went searching at my registrar, Gandi.Net, and saw that they had an example of how to do this, using an older API. So I created a new version based on that with their v5 API.

How Does This Do?

  • Installs a systemd user timer and user service.
  • Accepts necessary parameters (API key, domain name, subdomain)
  • Determines your IPv4 and/or IPv6 address
  • Submits those 4 pieces of information to Gandi.Net to create or update an A and/or AAAA record with a TTL of 30m

Installation

git clone https://github.com/KlfJoat/gandi.net-dns-dynamic.git
cd gandi.net-dns-dynamic
make install

Setup

(stub)

Prerequisite: Pay for a domain hosted by Gandi.Net.

  1. Go to Gandi.Net
  2. Create an API key
  3. Configure the API key in the systemd service or in the script itself
  4. Configure the domain in the systemd service or in the script itself
  5. Choose a subdomain (defaults to hostname --short) and configure it if necessary

See the script itself for all configuration options at the top.

Future Enhancements

  1. I should really create a dotfile for the configuration of this.
  2. I should make the Setup section above clearer and more step-by-step.

Contributions

I might accept PRs, I might not. I'm trying to keep this relatively simple. But give it a shot if you have something to add!