dns

DNS source of truth for curiousengine.org, applied to Namecheap.

Namecheap's setHosts API replaces the complete host-record set. Keep every record for the domain in curiousengine.org.yaml; anything missing from the YAML can be removed at Namecheap during apply.

Setup

1. Copy .env.example to .env.
2. Fill in your Namecheap API credentials.
3. Enable API access in Namecheap and whitelist NAMECHEAP_CLIENT_IP.
4. Replace the example records in curiousengine.org.yaml with the real zone.

Commands

Validate the local YAML:

.\bin\dns.ps1 validate

Show the difference between Namecheap and the YAML:

.\bin\dns.ps1 diff

Back up the current Namecheap zone XML:

.\bin\dns.ps1 backup

Apply the YAML to Namecheap:

.\bin\dns.ps1 apply

Use -Yes for non-interactive apply:

.\bin\dns.ps1 apply -Yes

Print current remote records:

.\bin\dns.ps1 pull

YAML schema

domain: curiousengine.org

records:
  - host: "@"
    type: A
    value: "203.0.113.10"
    ttl: 1800

  - host: "www"
    type: CNAME
    value: "curiousengine.org."
    ttl: 1800

  - host: "@"
    type: MX
    value: "mail.curiousengine.org."
    mx_pref: 10
    ttl: 1800