Dynamic DNS update client for domains hosted at netcup
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
NekuSoul 71fa5610ec Public ip record will only be refreshed if update successful 11 months ago
.idea Initial release 11 months ago
extras/systemd-timer Fixed systemd timer description 11 months ago
.gitignore Initial release 11 months ago
LICENSE.md Initial release 11 months ago
README.md Fixed README 11 months ago
install.sh Initial release 11 months ago
ncddns.conf.example Initial release 11 months ago
ncddns.py Public ip record will only be refreshed if update successful 11 months ago
netcupapi.py Initial release 11 months ago

README.md

ncddns

Dynamic DNS update client for domains hosted at netcup.

Features

  • Updates a single IPv4 DNS record based on the clients public IP address.
  • Only updates DNS record if the public IP has actually changed.
  • Includes install script as well as systemd service and timer for periodical updates.

Limitations

  • Only works with IPv4

Usage

Requirements

How to use

  • Grab the latest release.
  • Create your personal API key and password through the netcup customer control panel.
  • Create the DNS record you wish to update through the netcup customer control panel. This tool will not automatically create a new entry.
  • Create a ncddns.conf file based on the provided example config.
  • Run the client with python3: python3 ncddns.py or just python ncddns.py depending on your system.

How to install on Linux

  • Grab the latest release.
  • Make the install script executable: chmod u+x ./install.sh.
  • Run the install script as root: sudo ./install.sh.
  • The application is now installed at /opt/ncddns.
  • Make sure to create the ncddns.conf before you use the application.

How to install the systemd timer

  • Make sure the application is installed and configured correctly.
  • Move into the directory of the installation script: cd extras/systemd-timer
  • Make the install script executable: chmod u+x ./install.sh.
  • Run the install script as root: sudo ./install.sh.
  • The service ncddns.service and timer ncddns.timer are now installed and active.
  • The timer will run every 15 minutes. If necessary, change this behaviour in /etc/systemd/system/ncddns.timer.