# Ddclient

Ddclient is a Perl-based client that keeps dynamic DNS (DDNS) records in sync with your current public IP address. It is open source and self-hosted, installable on Docker Hub, Proxmox, Kubernetes (Helm), ZimaOS and Unraid.

Canonical page: https://ourlocalhost.com/app/361/ddclient

## Description

Ddclient is a Perl-based client that keeps dynamic DNS (DDNS) records in sync with your current public IP address. It supports many DNS providers, including Cloudflare, deSEC, and DigitalOcean, and can fetch your public IP in several different ways, giving self-hosters a lightweight, provider-agnostic alternative to vendor-supplied DDNS tools.

## Platform availability

Available on 4 of 9 platforms: Unraid, ZimaOS, Proxmox, Helm.

## Health score

71/100 (Good), based on 4 of 5 factors.
- Maintained: 77 (last commit 122 days ago)
- Popular: 71 (3,560 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Security check: 64 (no serious findings, CI, OpenSSF Scorecard 3.3/10)

## Links

- Documentation: https://ddclient.net
- Docker Hub: https://hub.docker.com/r/linuxserver/ddclient
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=ddclient
- Kubernetes (Helm): https://artifacthub.io/packages/helm/alekc/ddclient
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/ddclient
- Unraid: https://ca.unraid.net/apps/ddclient-0dzvjbp1vb8uyp?q=ddclient
- GitHub: https://github.com/linuxserver/docker-ddclient
- Official website: https://ddclient.net

## Common questions

### How do I make ddclient run as a daemon with a fixed update interval?

Edit /etc/default/ddclient and set run_daemon to the string true. Set daemon_interval to the number of seconds you want between dynamic DNS updates.

### Why might ddclient not pick up an IP change made through a provider's web interface?

ddclient relies on its own cache to verify IP changes instead of querying DNS. This is intended to avoid problems caused by bad DNS servers or propagation delays.

### Which common IP-fetching source can cause ddclient to record the wrong address?

The park-your-domain IP-fetching source can cause ddclient to set configured domains to 1.0.1.1.

### Can ddclient update self-hosted DNS servers using RFC 2136?

Yes, ddclient supports RFC 2136 updates through protocol=nsupdate for services such as ISC BIND, Knot DNS, and Technitium DNS Server. DynV6 can also use protocol=dyndns2 or nsupdate.

### What should I check before reporting a ddclient problem?

Check that the issue is not a duplicate and that it still occurs on the latest version of ddclient. Then create a GitHub issue if you need help or want to report a bug.

---
Source: Our Local Host (https://ourlocalhost.com/app/361/ddclient), the self-hosted and open-source app directory.