subdy docs
Guides

dyndns on routers & NAS

Keep your home IP up to date from Fritz!Box, OpenWRT or Synology.

At the end your router will update myapp.subdy.io automatically every time your ISP hands you a new IP.

Subdy speaks the standard dyndns2 protocol (every plan). Everything needs three values:

  • Update URL: https://api.subdy.io/nic/update
  • Username: anything (your email by convention)
  • Password: an API token from API & MCP

Fritz!Box (FRITZ!OS 7/8)

Internet → Permit Access → DynDNS, provider Custom:

Update-URL: https://api.subdy.io/nic/update?hostname=<domain>&myip=<ipaddr>
Domainname: myapp.subdy.io
Username:   you@example.com
Password:   <your sbdy_ token>

OpenWRT (23.05+, ddns-scripts)

/etc/config/ddns
config service 'subdy'
    option enabled '1'
    option service_name 'dyndns.org'
    option lookup_host 'myapp.subdy.io'
    option domain 'myapp.subdy.io'
    option username 'you@example.com'
    option password '<your sbdy_ token>'
    option update_url 'https://api.subdy.io/nic/update?hostname=[DOMAIN]&myip=[IP]'
    option use_https '1'

Synology DSM (7.x)

Control Panel → External Access → DDNS → Add, provider Customize:

Query URL: https://api.subdy.io/nic/update?hostname=__HOSTNAME__&myip=__MYIP__

then enter hostname, your email and the token.

Verifying

Responses follow the dyndns2 convention: good <ip> (updated), nochg <ip> (already current), badauth, nohost, !donator (plan without dyndns), 911 (temporary error). Test by hand — see the dyndns2 endpoint reference.