texasaggie97/hover-dns-updater

•Updated about 2 years ago

Script that will keep hover.com DNS up to date with dynamic DNS.

Image

Networking

10K+

texasaggie97/hover-dns-updater repository overview


main branch status
GitHub status
Versions	1.0.1


Info	Hover DNS Updater for Dynamic IP. See GitHub⁠ for the latest source.
Author	Mark Silva, based on a script from GitHub⁠ by Andrew Barilla
lmann99	Kept it running while I did not have access to github and added 2FA support

⁠About

hover-dns-updater will update the Hover DNS entries for one or more DNS records based on the external IP address. hover-dns-updater can do this one time or can run continuously checking after a certain amount of time.

I lost access to my GitHub account and they were not able to help me recover it. The old account has been renamed texasaggie97-zz and I have back texasaggie97. Given this though, the original repo name has been retired and cannot be used, so I have renamed the repo to hover-dns-updater-new :(

⁠Installation

⁠Prerequisites:

Python 3.10
- Download⁠
pip
- Linux - sudo apt-get install -y python3-pip
- Windows - python -m ensurepip --upgrade
- pip install -U pip
Poetry
- pip install -U poetry==1.8.2
- poetry install - this will create the poetry venv with all dependencies installed

⁠Hover TOPT Key:

Login to Hover.com⁠
Enable 2FA and manually setup mobile app with the secret key. Save secret key as configuration value 'toptkey'. ** Note: remove spaces from key displayed at end of text "If you can't scan the code, enter this secret key manually: xxxx xxxx xxxx xxxx xxxx xxxx xx" (https://help.hover.com/hc/en-us/articles/217282267-Enable-two-step-sign-in-on-your-Hover-account⁠)

⁠Hover DNS IDs:

Login to Hover.com⁠
In the same browser go to https://www.hover.com/api/domains/YOURDOMAIN.COM/dns⁠ replacing YOURDOMAIN.COM with the domain you want to update
This will return a json file. If you use Firefox, this will be nicely formatted.
In the "entries" list, look for the DNS records you want to keep up to date and make a note of the associated "id"s. They should look something like "dns1234567"

⁠Install Ubuntu service:

Copy INSTALL.sh, hover-dns-updater.service, and hover-dns-updater.py to a folder on you Ubuntu system
./INSTALL.sh
This will install and enable, but not start, the hover-dns-updater service
sudo nano /etc/hover-dns-updater/hover-dns-updater.json (or use the editor of your choice)
- Fill in your hover username and password
- Add the dns ids you noted above
- Optional - change None to the log file name
- Optional - change poll time, in seconds. Default is 10 minutes
- When running as an Ubuntu service, the service value in the confg file is ignored.
After configuration file is updated, start the service sudo service hover-dns-updater start
Option - Verify service started correctly sudo service hover-dns-updater status

⁠Create Docker container

docker build -t hover-dns-updater . ; docker tag hover-dns-updater texasaggie97/hover-dns-updater:latest texasaggie97/hover-dns-updater:vX.X.X ; docker push texasaggie97/hover-dns-updater

⁠RancherOS

Here are the docker-compose.yml and rancher-compose.yml to easily recreate the container.

⁠docker-compose.yml:

version: '2'
volumes:
    logs:
        external: true
        driver: rancher-nfs

services:
    hover-dns-updater:
        image: texasaggie97/hover-dns-updater
        environment:
            USERNAME: "username"
            PASSWORD: "password"
            TOPTKEY: "secret code"
            DNS1: "dns00000000"
            DNS2: "dns00000001"
            LOGFILE: "/logs/docker-hover-dns-updater.log"
        stdin_open: true
        working_dir: /hover-dns-updater
        volumes:
        - logs:/logs
        tty: true
        command:
        - python
        - hover-dns-updater.py
        - --service
        labels:
            io.rancher.container.pull_image: always

⁠rancher-compose.yml:

version: '2'
services:
    alarmserver:
        scale: 1
        start_on_create: true
    hover-dns-updater:
        scale: 1
        start_on_create: true

⁠Contributing

Contributions are welcome!

⁠Commands to use

poetry run black . - linter, may update formatting if required
poetry run flake8
poetry run pytest - only test currently is a simple one that will pass if the file is loadable

⁠Bugs / Feature Requests

To report a bug or submit a feature request, please use the GitHub issues page⁠.

⁠License

hover-dns-updater is licensed under an GPL-style license (see LICENSE⁠). Other incorporated projects may be licensed under different licenses.

Tag summary

Recent tags

Content type

Image

Digest

sha256:6736f41a6…

Size

134.2 MB

Last updated

about 2 years ago

docker pull texasaggie97/hover-dns-updater:v1.0.1