A tiny, fast, multi-platform Namecheap Dynamic DNS updater written in Rust.

• 🚀 Lightweight (distroless image)
• 🧩 Runs on amd64, arm64, and armv7 (Raspberry Pi)
• 🌍 Multiple IPv4 detection providers with failover
• 🔁 Only updates DNS when your IP actually changes
• 📝 Configurable logging (compact, raw, JSON)
• 🐳 Minimal Docker footprint
• 🔒 Written in safe Rust

• Supports multiple hosts: @,www,api
• Retrieves your public IPv4 from multiple fallback providers
• Parses Namecheap XML responses and reports errors properly
• Local caching (/data/last_ip) to avoid unnecessary DNS updates
• Fully static, runs on any platform
• Clean Docker logs using LOG_STYLE

docker run \
  --name namecheap-ddns \
  --restart=always \
  -e NC_DOMAIN="example.com" \
  -e NC_PASSWORD="your-ddns-password" \
  -e NC_HOSTS="@,*" \
  -e LOG_STYLE="compact" \
  -v ddns-data:/data \
  elob/namecheap-ddns:latest

Logging can be customized using two environment variables:

Supported values:

-e LOG_STYLE=compact

Standard Rust filtering:

RUST_LOG=info
RUST_LOG=warn
RUST_LOG=debug
RUST_LOG=trace

-e RUST_LOG=debug

The container stores the last known IP here:

/data/last_ip

To persist between restarts:

docker run --rm \
  -v namecheap_data:/data \
  ...

services:
  ddns:
    image: elob/namecheap-ddns:latest
    restart: always
    environment:
      NC_DOMAIN: "example.com"
      NC_PASSWORD: "your-ddns-password"
      NC_HOSTS: "@,www"
      LOG_STYLE: "compact"
      RUST_LOG: "info"
    volumes:
      - ddns-data:/data

volumes:
  ddns-data:

This project uses cargo-release to automate versioning, tagging, and preparing releases.

cargo install cargo-release

Examples:

# cargo release patch
# cargo release minor
# cargo release major

# Specific version
cargo release 1.2.0

This will:

• Update version in Cargo.toml
• Commit the change
• Create a git tag like v1.2.0
• Push commit + tag
• Start next dev cycle (1.2.1-alpha.0)

VERSION=$(cargo pkgid | sed 's/.*#//')

docker buildx build \
  --platform linux/amd64,linux/arm64,linux/arm/v7 \
  -t elob/namecheap-ddns:latest \
  -t elob/namecheap-ddns:${VERSION} \
  --push .

docker pull elob/namecheap-ddns:${VERSION}
docker pull elob/namecheap-ddns:latest

[INFO] IPv4 detected: 81.234.220.45
[INFO] Updated host=@ successfully

[ERROR] Namecheap update failed for host=@: Domain name not found

[TRACE] <interface-response>...</interface-response>

MIT