Client Setup

The simplest way to update your host — one line, no dependencies. Useful for cron jobs, scripts, and testing.

$ curl "https://novadns.io/api/update?token=YOUR_TOKEN"

To pass an explicit IP instead of auto-detecting:

$ curl \
  "https://novadns.io/api/update
    ?token=YOUR_TOKEN
    &myip=203.0.113.42"

To run every 5 minutes via cron:

# m  h  dom mon dow  command
*/5  *  *  *  *  curl -s "https://novadns.io/api/update?token=YOUR_TOKEN" > /dev/null

ddclient is the most widely used Linux DDNS client. It runs as a daemon and updates your hostname automatically when your IP changes.

# NovaDNS configuration for ddclient
# Install: sudo apt install ddclient

protocol=dyndns2
server=novadns.io
login=YOUR_HOST_USERNAME
password=YOUR_HOST_PASSWORD
use=web, web=checkip.dyndns.com
ssl=yes
daemon=300   # check every 5 minutes

home.novaip.link

Restart ddclient after editing: sudo systemctl restart ddclient. Check status with sudo ddclient -verbose -noquiet -debug.

inadyn is a modern, lightweight DDNS client available on OpenWrt, Entware, and most Linux distributions.

# NovaDNS configuration for inadyn
# Install: sudo apt install inadyn

period          = 300  # seconds
user-agent      = inadyn/2.0

provider default@dyndns.org {
  ssl        = true
  server-name = novadns.io
  server-url  = "/nic/update?hostname=%h&myip=%i"
  username    = YOUR_HOST_USERNAME
  password    = YOUR_HOST_PASSWORD
  hostname    = home.novaip.link
}

Start inadyn: sudo inadyn --foreground --once to test, then sudo systemctl enable --now inadyn to run as a service.

Most routers and NAS devices have a built-in DynDNS client under their DDNS or dynamic DNS settings. Username and password are the host's Basic Auth credentials from the dashboard (host settings → Basic Auth credentials), not your account login.

Confirmed working with the following firmware and devices: