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
- Open Domains → domain name → DNS.
- In the row of the A or AAAA record click the up and down arrows icon (or ⋮ → Dynamic DNS).
- 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:
| Field | Value |
|---|---|
| Update URL | https://sitelyra.it/api/nic/update?hostname=<name>&myip=<ipaddr> |
| Hostname / domain | the record's full name, for example home.example.com |
| Username | the record's full name |
| Password | the 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
| Response | Meaning |
|---|---|
good 203.0.113.10 | record updated with the given address |
nochg 203.0.113.10 | the address was already that one: no change |
badauth | wrong key or dynamic DNS turned off |
nohost | the name does not match the record, or the record is gone |
numhost | there are several records with that name and type |
abuse | too many calls: at most one per minute per record |
dnserr | address 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.