Keep your domain pointing to your server even when your ISP changes your IP. nself-ddns monitors your external IP on a configurable interval and updates DNS records automatically via Cloudflare or Route53. Essential for self-hosters on residential or dynamic connections.
Set your license key with nself license set nself_pro_... before installing.
nself license set nself_pro_...
nself plugin install ddns
nself build
nself start| Variable | Required | Default | Description |
|---|---|---|---|
PLUGIN_DDNS_PROVIDER | Yes | — | DNS provider: cloudflare or route53 |
PLUGIN_DDNS_DOMAIN | Yes | — | Hostname to update, e.g. home.example.com |
PLUGIN_DDNS_CHECK_INTERVAL | No | 5m | How often to check for IP changes (e.g. 2m, 10m) |
PLUGIN_DDNS_CLOUDFLARE_TOKEN | Cloudflare | — | API token with DNS:Edit for the target zone |
PLUGIN_DDNS_CLOUDFLARE_ZONE_ID | Cloudflare | — | Zone ID from Cloudflare dashboard |
On startup and at each check interval, the plugin fetches your current external IP from a pool of reliable sources (ifconfig.me, ipify.org). If the IP has changed since the last update, it calls the DNS provider API to update the A record. Changes are logged with before/after IP for audit purposes.
| Endpoint | Method | Description |
|---|---|---|
/ddns/status | GET | Current IP, last check time, last update time |
/ddns/force-update | POST | Trigger an immediate IP check and update |
/ddns/history | GET | Log of IP changes with timestamps |
/health | GET | Plugin health check |
nself plugin remove ddnsPort: 3217 | Category: Infrastructure | Last Updated: April 2026 | Plugin Version 1.1.1