ownDynDNS

Self-hosted dynamic DNS php script to update netcup DNS API from Router like AVM FRITZ!Box

Authors

Felix Kretschmer @fernwerker
Philipp Tempel @philipptempel
Branko Wilhelm @b2un0

Usage

Installation

Copy all files to your webspace
create a copy of .env.dist as .env and configure:
- username -> The username for your Router to authenticate (so not everyone can update your DNS)
- password -> password for your Router
- apiKey -> API key which is generated in netcup CCP
- apiPassword -> API password which is generated in netcup CCP
- customerId -> your netcup Customer ID
- debug -> true|false enables debug mode and generates output of update.php (normal operation has no output)
Create each host record in your netcup CCP (DNS settings) before using the script. The script does not create any missing records.

AVM FRITZ!Box Settings

Go to "Internet" -> "Freigaben" -> "DynDNS"
Choose "Benutzerdefiniert"
Update-URL: https://<url of your webspace>/update.php?user=<username>&password=<pass>&ipv4=<ipaddr>&ipv6=<ip6addr>&domain=<domain>
- only the url needs to be adjusted, the rest is automatically filled by your AVM FRITZ!Box
- http or https is possible if valid SSL certificate (e.g. Let's Encrypt)
Single Domain:
- Domainname: <host record that is supposed to be updated>
Multiple Domains:
- Domainname: <first host record that is supposed to be updated>,<second host record that is supposed to be updated>,....
Username: <username as defined in .env file>
Password: <password as definied in .env file>

run as cronjob on a **nix based device

see examples

References

DNS API Documentation: https://ccp.netcup.net/run/webservice/servers/endpoint.php
Source of dnsapi.php: https://ccp.netcup.net/run/webservice/servers/endpoint.php?PHPSOAPCLIENT

License

Published under GNU General Public License v3.0
© Felix Kretschmer, 2021