ClouDNS DDNS Update Client README

This is a simple python app to manage DyDNS updates for hostnames powered by ClouDNS's DNS service. This app currently depends on the user manually creating and entering ClouDNS update URLs, but I plan to integrate this client with the ClouDNS in the very near future.

Installation

This client can currently be installed as systemd service on most Unix distributions.

To install(or update) this client as a system service:

curl -fsSL https://raw.githubusercontent.com/rjojjr/cloudns-ddns-client/master/scripts/linux-installer.sh | sudo bash

USAGE

Adding Hostnames

To add a ClouDNS hostname to be updated, run this app with the -a(or --add-hostname) flag followed by the hostname and then the DyDNS update URL provided by the ClouDNS webapp.

EX:

python3 src/main.py -a example.com https://ipv4.cloudns.net/api/dynamicURL/?q=XyZ...

OR(when installed as system service on a Unix-based host)

cloudns-client -a example.com https://ipv4.cloudns.net/api/dynamicURL/?q=XyZ...

Updating Hostnames

To start the app in update mode, simply run the program with no arguments:

python3 src/main.py

OR(when installed as system service on a Unix-based host)

cloudns-client

Setting Update Interval

To change the update interval(defaults to 15 minutes), run the client with the -uim(or --update-interval-minutes) flag followed by your desired update interval in minutes:

# Set interval to 10 minutes
python3 src/main.py -uim 10

OR(when installed as system service on a Unix-based host)

cloudns-client -uim 10