Troubleshooting xProDDNS: Common Issues and Quick Fixes
1. No DNS updates (hostname not resolving)
Possible causes:
- Client not running — xProDDNS updater/service stopped.
- Credentials invalid — API key/username or password changed.
- Network blocked — outbound requests to xProDDNS API blocked by firewall. Quick fixes:
- Restart the updater/service on the client device.
- Verify credentials in the updater: re-enter API key/username and test.
- Check network access: from the client run:
or use your updater’s test option. Allow outbound HTTPS (port 443) in firewall if blocked.
- Inspect logs in /var/log/xproddns or the updater GUI for specific error codes and search the error code in xProDDNS docs.
2. IP shows wrong public address
Possible causes:
- Client behind double NAT or using local gateway IP; updater reads local interface instead of public IP.
- ISP uses CGNAT. Quick fixes:
- Enable “detect public IP” in updater (if available) so it queries an external service.
- Use an external IP discovery URL in settings (e.g., ipify or ifconfig.co) supported by xProDDNS.
- Check for CGNAT: if ISP uses Carrier-Grade NAT, contact ISP for a public IP or use a VPN with a static exit IP.
3. Frequent update rate limiting or “too many updates”
Possible causes:
- Rapid IP flaps, or updater misconfigured to update too often. Quick fixes:
- Set a minimum update interval (e.g., 5–15 minutes) in the client.
- Enable change-detection so updates occur only when IP actually changes.
- Investigate network stability: resolve frequent disconnects at modem/router or ISP level.
4. DNS resolves intermittently or slow propagation
Possible causes:
- TTL settings too high/low; DNS caching; upstream resolver issues. Quick fixes:
- Check and adjust TTL in xProDDNS dashboard to a lower value (e.g., 60–300s) for faster updates, then raise again once stable.
- Clear local DNS cache on affected machines:
- Windows:
ipconfig /flushdns - macOS:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder - Linux (systemd):
systemd-resolve –flush-cachesorsudo systemd-resolve –flush-caches
- Windows:
- Test from multiple public DNS servers (8.8.8.8, 1.1.1.1) to isolate resolver caching issues.
5. Authentication errors (⁄403) from API
Possible causes:
- Expired or revoked API key; incorrect request signing; account restrictions. Quick fixes:
- Regenerate API key in the xProDDNS account portal and update the client.
- Ensure correct timezone and system clock — OAuth or signed requests may fail with skewed clocks; sync via NTP.
- Confirm account status isn’t suspended and the hostname is allowed under your plan.
6. SSL/TLS handshake or certificate errors
Possible causes:
- Client using outdated CA bundle, system clock skew, or middlebox intercepting HTTPS. Quick fixes:
- Update CA certificates on the client (e.g., ca-certificates package).
- Ensure system time is correct (use NTP).
- Inspect TLS interception by corporate proxies; add exceptions or configure proxy credentials.
7. Hostname already in use / DNS conflicts
Possible causes:
- Hostname duplicated across
Leave a Reply