hover-ddns is a DDNS client that will update a DNS A and/or AAAA record at hover with the current public IP address(es) of the machine.
This is an unofficial client using the non-supported Hover API.
It will:
- Determine the current public IP address of the host machine
- Authenticate against the Hover API
- Create or update the DNS entry for the specified hostname
It doesn't do anything beyond that and if you need more features or different services, I suggest to look at tools like lexicon.
- IPv4 and IPv6 supported
- Supports public IP lookup by:
- Using the ipify API
- Issuing OpenDNS DNS queries
- Extracting the address from a lokal network interface
- Cron syntax can be used to schedule periodic updates
Create a config file with your credentials and domain info (see the provided example.yaml) and then run hover-ddns:
$ hover-ddns --config config.yaml
Download the deb corresponding to your architecture from the releases page and run the following commands.
$ sudo dpkg -i [downloaded_deb.deb]
[Customize /etc/hover-ddns.yaml with your domain information and other preferences]
$ sudo systemctl start hover-ddns.service
This is an example setup on Linux using the provided systemd service and timer.
Download the latest release and run the following commands.
$ tar xvf [downloaded_archive.tar.gz]
$ sudo mv hover-ddns /usr/local/bin
$ vim example.yaml
[Add your credentials and domain info]
$ sudo mv example.yaml /etc/hover-ddns.yaml
# Make sure only root can read the file with sensitive information
$ sudo chown root:root /etc/hover-ddns.yaml
$ sudo chmod 600 /etc/hover-ddns.yaml
$ sudo mv hover-ddns.service /etc/systemd/system/
$ sudo systemctl daemon-reload
$ sudo systemctl enable hover-ddns.service
$ sudo systemctl start hover-ddns.service