Dynamic DNS

Dynamic DNS keeps an A (IPv4) or AAAA (IPv6) record up to date when your connection's IP address changes: home, office, a camera or a server behind a router without a fixed IP. It works with your domains' DNS management and is included at no cost.

Enable it

  1. Open Domains → domain name → DNS.
  2. In the row of the A or AAAA record click the up and down arrows icon (or ⋮ → Dynamic DNS).
  3. Click Enable. The update URL, the cron line and the router settings appear, each with a Copy button.

There must be a single record with that name and type: if there are two (for example two A records on home), dynamic DNS cannot tell which one to update. The dynamic record shows the Dynamic label in the list.

You can show the key again at any time from the same window with URL and key.

From a script or cron

Call the update URL (GET or POST): the record takes the IP address the call comes from.

https://sitelyra.it/api/ddns/YOUR-KEY

To set the address yourself add ?ip=:

https://sitelyra.it/api/ddns/YOUR-KEY?ip=203.0.113.10

To check it every 5 minutes with cron, on Linux or macOS:

*/5 * * * * curl -fsS "https://sitelyra.it/api/ddns/YOUR-KEY" >/dev/null

From the router (dyndns2)

Many routers and programs already speak the dyndns2 protocol: Fritz!Box, MikroTik, Synology, OpenWrt, ddclient and others. Choose a custom provider (or «dyndns2») and enter:

FieldValue
Update URLhttps://sitelyra.it/api/nic/update?hostname=<name>&myip=<ipaddr>
Hostname / domainthe record's full name, for example home.example.com
Usernamethe record's full name
Passwordthe dynamic DNS key

The router replaces <ipaddr> with its address (the placeholder differs between routers: for example <ipaddr> on a Fritz!Box). Without myip the address the call comes from is used.

With ddclient (/etc/ddclient.conf):

protocol=dyndns2
server=sitelyra.it
script=/api/nic/update
ssl=yes
login=home.example.com
password=YOUR-KEY
home.example.com

Responses

ResponseMeaning
good 203.0.113.10record updated with the given address
nochg 203.0.113.10the address was already that one: no change
badauthwrong key or dynamic DNS turned off
nohostthe name does not match the record, or the record is gone
numhostthere are several records with that name and type
abusetoo many calls: at most one per minute per record
dnserraddress not valid for the record type, or temporary error: try again later

IPv6

For an AAAA record the call must arrive over IPv6 (for example curl -6 …), or carry the address in ?ip= or myip=. An IPv4 address on an AAAA record (or the other way round) is rejected.

Regenerate the key or turn it off

From the record's Dynamic DNS window:

  • Regenerate key: the previous key stops working at once; update routers and scripts with the new one.
  • Disable: the key no longer works and the record keeps its last address.

If you delete the record, dynamic DNS is turned off too.

Treat the key like a password: whoever knows it can change the record's address. Every change is kept in the activity log.