diff --git a/pages/common/acme.sh-dns.md b/pages/common/acme.sh-dns.md new file mode 100644 index 0000000000..77dd81aaef --- /dev/null +++ b/pages/common/acme.sh-dns.md @@ -0,0 +1,24 @@ +# acme.sh --dns + +> Use a DNS-01 challenge to issue a TLS certificate. +> More information: . + +- Issue a certificate using an automatic DNS API mode: + +`acme.sh --issue --dns {{gnd_gd}} --domain {{example.com}}` + +- Issue a wildcard certificate (denoted by an asterisk) using an automatic DNS API mode: + +`acme.sh --issue --dns {{dns_namesilo}} --domain {{example.com}} --domain {{*.example.com}}` + +- Issue a certificate using a DNS alias mode: + +`acme.sh --issue --dns {{dns_cf}} --domain {{example.com}} --challenge-alias {{alias-for-example-validation.com}}` + +- Issue a certificate while disabling automatic Cloudflare / Google DNS polling after the DNS record is added by specifying a custom wait time in seconds: + +`acme.sh --issue --dns {{dns_namecheap}} --domain {{example.com}} --dnssleep {{300}}` + +- Issue a certificate using a manual DNS mode: + +`acme.sh --issue --dns --domain {{example.com}} --yes-I-know-dns-manual-mode-enough-go-ahead-please` diff --git a/pages/common/acme.sh.md b/pages/common/acme.sh.md index be0e0f7282..a875f77d88 100644 --- a/pages/common/acme.sh.md +++ b/pages/common/acme.sh.md @@ -1,15 +1,16 @@ # acme.sh > Shell script implementing ACME client protocol, an alternative to certbot. +> See also `acme.sh dns`. > More information: . - Issue a certificate using webroot mode: `acme.sh --issue --domain {{example.com}} --webroot {{/path/to/webroot}}` -- Issue a certificate using standalone mode using port 80: +- Issue a certificate for multiple domains using standalone mode using port 80: -`acme.sh --issue --standalone --domain {{example.com}}` +`acme.sh --issue --standalone --domain {{example.com}} --domain {{www.example.com}}` - Issue a certificate using standalone TLS mode using port 443: @@ -23,13 +24,9 @@ `acme.sh --issue --apache --domain {{example.com}}` -- Issue a wildcard (\*) certificate using a manual DNS mode: +- Issue a wildcard (\*) certificate using an automatic DNS API mode: -`acme.sh --issue --dns --domain {{example.com}}` - -- Issue a certificate using an automatic DNS API mode: - -`acme.sh --issue --dns {{dns_cf}} --domain {{example.com}}` +`acme.sh --issue --dns {{dns_cf}} --domain {{*.example.com}}` - Install certificate files into the specified locations (useful for automatic certificate renewal):