Skip to content
This page was translated with AI and may contain inaccuracies. Help improve it on GitHub.

Dynamic DNS (DDNS) ​

The public IP of a home broadband connection changes over time. DDNS updates your DNS records automatically after an IP change, so your domain always points to your current address.

Supported providers ​

Alibaba Cloud, Cloudflare, Tencent Cloud, DNSPod, Huawei Cloud, GoDaddy, Porkbun, dynv6, DuckDNS, Amazon Route 53, OVHcloud, Gandi, NS1, Bunny DNS, Namecheap, DynDNS2, and a custom callback (for providers that are not built in, or for self-hosted endpoints).

ProviderCredentialsUsable for certificate DNS validation
Amazon Route 53Access Key ID / Secret Access Key, optional hosted zone IDYes
OVHcloudApplication Key / Secret and Consumer Key; endpoint ovh-eu / ovh-ca / ovh-usYes
GandiPersonal Access TokenYes
NS1API KeyYes
Bunny DNSAccount API KeyYes
NamecheapThe domain's Dynamic DNS password (A records only)No
DynDNS2Username, password and update URL; for No-IP, Dynu and other services compatible with the dyndns2 protocolNo

How the IP is obtained ​

  • URL: request a public-IP lookup address (replace it with any service you like, or host your own);
  • Network interface: read the address of a specific network interface directly, suited to devices that hold a public IP;
  • Command: run a command and use its output, suited to unusual network setups.

Both IPv4 and IPv6 are supported.

Notifications ​

A Webhook can be called when the IP changes or a sync fails.

Recommendations ​

  • Create a sub-account key limited to DNS record editing for your DNS provider. Avoid using the main account key;
  • After creating a task, click "Force sync" to confirm that the record has been updated;
  • The public-IP lookup address no longer depends on any service operated by the project, and you can change it in a task at any time.

Migrating from Lucky ​

DDNS tasks can be imported from lucky_ddns.lkcf, covering 11 providers. Lucky's official IP lookup addresses are removed during import. See the Migration Guide for details.

Released under the Apache-2.0 license.