Namecheap DDNS

Namecheap DDNS is a lightweight container that keeps a Namecheap dynamic DNS (DDNS) record in sync with your current public IP address.

  • Network Services
  • Tools & Utilities
Namecheap DDNS is a lightweight container that keeps a Namecheap dynamic DNS (DDNS) record in sync with your current public IP address. It runs on a schedule and pushes each address change to the A + Dynamic DNS record you configure for your domain. It is for self-hosters who register with Namecheap and want a simple, unattended way to keep home-lab services reachable when their IP changes.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

40/100 Fair

Maintained
39last commit 336 days ago
Popular
2517 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
66no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 2.5/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 42 days ago

GitHub stars
17
Open issues
2
Last commit
2025-12-20
Latest release
v0.4.0
License
MIT
Activity
stale

Checked 18 days ago - source: GitHub (nickjer/namecheap-ddns)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add Namecheap API details and current IP Fill in the provider with user_name, api_user, api_key, client_ip, and normally use_sandbox = false. If those are missing or wrong, especially an old client_ip, Namecheap will reject the DNS update and nothing changes. source
  • Pick OVERWRITE or MERGE carefully If you already have DNS records, use mode = "MERGE" so Terraform only changes the records you list. OVERWRITE replaces the entire record set and can delete mail, subdomains, or other entries. source
  • Set email_type if the domain needs mail If the domain should handle email, set email_type to match your mail setup and add the required mail records. The wrong combination can cause mail to bounce or go to the wrong place. source
  • Namecheap-side prerequisites Create an 'A + Dynamic DNS' record for your host in Namecheap and enable Dynamic DNS on the domain's manage page before the container can update it. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which Namecheap credential should I provide to Namecheap-DDNS?

Set NAMECHEAP_DDNS_TOKEN to the Dynamic DNS Password from Namecheap's Advanced DNS control panel. It is not your Namecheap login password.

Does the domain need any special Namecheap DNS setup?

Dynamic DNS must be enabled, and the domain must be pointed to Namecheap BasicDNS, PremiumDNS, or FreeDNS.

Can I update several subdomains or force a specific IP?

You can pass multiple subdomains with -s or NAMECHEAP_DDNS_SUBDOMAIN, and optionally set a specific IP with -i or NAMECHEAP_DDNS_IP. If no IP is provided, the updater uses the IP used to make the request.

How can I schedule the updater on a Linux host?

Create a systemd service with the required environment variables and ExecStart path, then add a corresponding timer for scheduled runs.

Can I use the same tool outside the container?

Yes, you can download pre-compiled binaries or install it with cargo install namecheap-ddns.

Answers sourced from github.com, www.namecheap.com

Community

Collected 53 days ago - public community threads