Skip to content

DynDNS

DynDNS allows you to operate an A/AAAA record with a dynamic IP address and update it automatically whenever your IP changes. This is especially useful if you run a server at home and do not have a static IP address.

To use DynDNS, create a new entry under DynDNS. The hostname can either be the full subdomain name home.example.com or just the label home. Please make sure that no A/AAAA/CNAME/ALIAS record exists for the (sub)domain used here (for example home.example.com). Those records would conflict with the DynDNS entry and affect functionality.

To update the DynDNS entry, the update URL must be called with the appropriate parameters. You can view this URL in the portal.

The update URL has the following format:

https://api.ccp.realtoxmedia.de/api/domains/dyndns/<ID>?secret=<secret>&ipv4=<ipv4>&ipv6=<ipv6>

The ID and secret must always be provided. Depending on the software you use, IPv4 and IPv6 can be provided to update one or both addresses.

Warning

If IPv4 or IPv6 is not provided, the public IP address from which the request originated is used. For example, this may be the IPv6 address even though only IPv4 was intended. If both addresses are not explicitly provided via parameters, both are removed during the update and only the IP address submitted with the request is set.

Configuration Examples

Linux cron job with curl

First open the crontab menu with crontab -e and add the following line:

* * * * * curl -s -L "<Update-URL>" > /dev/null

The ipv4 and ipv6 parameters are not possible here. If you still want to update both addresses, you can do so by manually retrieving the IPv4 and IPv6 addresses. The update URL would then look like this:

https://api.ccp.realtoxmedia.de/api/domains/dyndns/<ID>?secret=<secret>&ipv4=$(curl -s https://api4.ipify.org)&ipv6=$(curl -s https://api6.ipify.org)

Windows task with PowerShell

Open Task Scheduler and create a new task. Then add the following action:

Program/script: powershell.exe
Add arguments: -Command "Invoke-WebRequest -Uri '<Update-URL>' -UseBasicParsing"

Here as well, the ipv4 and ipv6 parameters are not possible. If you still want to update both addresses, you can do so by manually retrieving the IPv4 and IPv6 addresses. The update URL would then look like this:

https://api.ccp.realtoxmedia.de/api/domains/dyndns/<ID>?secret=<secret>&ipv4=$(curl -s https://api4.ipify.org)&ipv6=$(curl -s https://api6.ipify.org)

Fritz!Box

Under Internet -> Shares -> DynDNS, use the following settings:

  • Provider: Custom
  • Update URL: <Update-URL> (the parameters &ipv4=<ipv4>&ipv6=<ipv6> can be used here)
  • Domain name: <Hostname> (for example home.example.com or home)
  • Username: none
  • Password: none

pfSense

Under Services -> Dynamic DNS, use the following settings:

  • Service Type: Custom
  • Interface to monitor: Your WAN interface
  • HTTP API DNS Options: true
  • Update URL: <Update-URL> (the parameters &ipv4=<ipv4>&ipv6=<ipv6> cannot be used here. Remove them.)

RouterOS

Under System -> Scheduler, create a new task with the following settings:

/tool fetch url="<Update-URL>" keep-result=no

The parameters &ipv4=<ipv4>&ipv6=<ipv6> cannot be used here. Remove them.