jaalto/project--ddns-updater

duckdns.org dns.he.org etc. Dynamic DNS (DDNS) client implemented in POSIX shell

DESCRIPTION

A generic dynamic DNS (DDNS) update client implemented in POSIX shell.

Any DDNS service provider providing HTTP or HTTPS update can be added. The update information can be found their API documention. Program includes few ready templates to start with:

• http://dns.he.net [1] (host your own DOMAIN and update using DDNS)
• http://duckdns.org [2] (US, free third level domains)
• http://dsnss.de [3] (EU, free third level domains)

See the examples/ directory.

How does it work?

Based on configured domains and credentials, the program periodically checks if IP address has changed and sends update requests. for each DDNS service provider:

1. Create a user account.
2. Select provided domain(s).
3. Copy the TOKEN or PASSWORD information to access your domain(s).
4. Update configuration files for each domain.
5. Configure update interval for a cron job.

After setting up configuration files, call program once from the command line to seed the initial IP. After that cron takes care of updates.

/usr/local/bin/ddns-updater --verbose

REQUIREMENTS

1. POSIX environment and standard utilities (grep, awk...)
2. POSIX /bin/sh and web client like curl(1) or wget(1).

INSTALL

See details in separate INSTALL file.

REFERENCES

• [1] Hurricane Electric https://dns.he.net/docs.html
• [2] https://www.duckdns.org/spec.jsp
• [3] https://ddnss.de/ua/help.php

COPYRIGHT AND LICENSE

Copyright (C) 2019-2021 Jari Aalto <jari.aalto@cante.net>

This project is free; you can redistribute and/or modify it under the terms of GNU General Public license either version 2 of the License, or (at your option) any later version.

Project homepage (bugs and source) is at https://github.com/jaalto/project--ddns-updater