/netcup

netcup DNS module for caddy: dns.providers.netcup

Primary LanguageGoMIT LicenseMIT

netcup DNS module for Caddy

This package contains a DNS provider module for Caddy. It can be used to manage DNS records with the netcup DNS API using libdns-netcup.

Caddy module name

dns.providers.netcup

Config examples

To use this module for the ACME DNS challenge, configure the ACME issuer in your Caddy JSON with your netcup credentials (guide) like so:

{
  "module": "acme",
  "challenges": {
    "dns": {
      "provider": {
        "name": "netcup",
        "customer_number": "{env.NETCUP_CUSTOMER_NUMBER}",
        "api_key": "{env.NETCUP_API_KEY}",
        "api_password": "{env.NETCUP_API_PASSWORD}"
      }
    }
  }
}

or with the Caddyfile:

your.domain.com {
	...
	tls {
		dns netcup {
			customer_number {env.NETCUP_CUSTOMER_NUMBER}
			api_key {env.NETCUP_API_KEY}
			api_password {env.NETCUP_API_PASSWORD}
		}
	}
	...
}

Attention: Slow Netcup propagation time

NOTE: You may need to set an unexpectedly high propagation time (≥ 900 seconds) to give the netcup DNS time to propagate the entries! This may be annoying when executing caddy run/start manually but should not be a problem in automated setups. In exceptional cases, 20 minutes may be required. See coldfix/certbot-dns-netcup/issues/28.

Use this config, (related Caddy Forum Post):

your.domain.com {
	...
	tls {
		dns netcup {
			...
		}
		propagation_timeout 900s
		propagation_delay 600s
		resolvers 1.1.1.1
	}
	...
}