Credentials and DNS configuration for DNS providers must be passed through environment variables.
The environment variables can reference a value.
Here is an example bash command using the Cloudflare DNS provider:
$ CLOUDFLARE_EMAIL=foo@bar.com \
CLOUDFLARE_API_KEY=b9841238feb177a84330febba8a83208921177bffe733 \
lego --dns cloudflare --domains www.example.com --email me@bar.com run
The environment variables can reference a path to file.
In this case the name of environment variable must be suffixed by _FILE
.
The file must contain only the value.
Here is an example bash command using the CloudFlare DNS provider:
$ cat /the/path/to/my/key
b9841238feb177a84330febba8a83208921177bffe733
$ cat /the/path/to/my/email
foo@bar.com
$ CLOUDFLARE_EMAIL_FILE=/the/path/to/my/email \
CLOUDFLARE_API_KEY_FILE=/the/path/to/my/key \
lego --dns cloudflare --domains www.example.com --email me@bar.com run
To resolve CNAME when creating dns-01 challenge:
set LEGO_EXPERIMENTAL_CNAME_SUPPORT
to true
.
Since: v3.9.0
Akamai edgedns supersedes FastDNS; implementing a DNS provider for solving the DNS-01 challenge using Akamai EdgeDNS
Since: v1.1.0
Configuration for Alibaba Cloud DNS.
Since: v0.5.0
Configuration for Amazon Lightsail.
Since: v0.3.0
Configuration for Amazon Route 53.
Since: v3.8.0
Configuration for ArvanCloud.
Since: v0.4.0
Configuration for Aurora DNS.
Since: v3.2.0
Configuration for Autodns.
Since: v0.4.0
Configuration for Azure.
Since: v2.6.0
Configuration for Bindman.
Since: v0.5.0
Configuration for Bluecat.
Since: v3.3.0
Configuration for Checkdomain.
Since: v2.3.0
Configuration for ClouDNS.
Since: v3.6.0
Configuration for CloudDNS.
Since: v0.5.0
Configuration for CloudXNS.
Since: v0.3.0
Configuration for Cloudflare.
Since: v1.2.0
Configuration for ConoHa.
Since: v3.4.0
Configuration for Constellix.
Since: v0.4.0
Configuration for DNS Made Easy.
Since: v0.4.0
Configuration for DNSPod.
Since: v0.3.0
Configuration for DNSimple.
Since: v2.2.0
Configuration for Designate DNSaaS for Openstack.
Since: v0.3.0
Configuration for Digital Ocean.
Since: v2.4.0
Configuration for Domain Offensive (do.de).
Since: v1.1.0
Configuration for DreamHost.
Since: v0.5.0
Configuration for Duck DNS.
Since: v0.3.0
Configuration for Dyn.
Since: v3.5.0
Configuration for Dynu.
Since: v2.6.0
Configuration for EasyDNS.
Since: v0.4.0
Configuration for Exoscale.
Since: v0.5.0 Solving the DNS-01 challenge using an external program.
Since: v0.3.0
Configuration for Gandi.
Since: v0.5.0
Configuration for Gandi Live DNS (v5).
Since: v0.5.0
Configuration for Glesys.
Since: v0.5.0
Configuration for Go Daddy.
Since: v0.3.0
Configuration for Google Cloud.
Since: v2.0.0
Configuration for HTTP request.
Since: v3.7.0
Configuration for Hetzner.
Since: v1.1.0
Configuration for Hosting.de.
Since: v3.9.0
Configuration for HyperOne.
Since: v2.0.0
Configuration for INWX.
Since: v4.1.0
Configuration for Infomaniak.
Since: v1.1.0
Configuration for Internet Initiative Japan.
Since: v4.2.0
Configuration for Ionos.
Since: v2.6.0
Configuration for Joker.
Since: v1.1.0
Configuration for Joohoi’s ACME-DNS.
Since: v1.1.0
Configuration for Linode (v4).
Since: v3.1.0
Configuration for Liquid Web.
Since: v4.2.0
Configuration for Loopia.
Since: v3.7.0
Configuration for LuaDNS.
Solving the DNS-01 challenge using CLI prompt.
Since: v1.2.0
Configuration for MyDNS.jp.
Since: v0.3.7
Configuration for MythicBeasts.
Since: v1.1.0
Configuration for NIFCloud.
Since: v0.4.0
Configuration for NS1.
Since: v0.5.0
Configuration for Name.com.
Since: v0.3.0
Configuration for Namecheap.
To enable API access on the Namecheap production environment, some opaque requirements must be met. More information in the section Enabling API Access of the Namecheap documentation. (2020-08: Account balance of $50+, 20+ domains in your account, or purchases totaling $50+ within the last 2 years.)
Since: v2.7.0
Configuration for Namesilo.
Since: v1.1.0
Configuration for Netcup.
Since: v3.7.0
Configuration for Netlify.
Since: v0.4.0
Configuration for OVH.
Since: v0.4.1
Configuration for Open Telekom Cloud.
Since: v2.3.0
Configuration for Oracle Cloud.
Since: v0.4.0
Configuration for PowerDNS.
Since: v0.3.0
Configuration for RFC2136.
Since: v0.4.0
Configuration for Rackspace.
Since: v0.3.5
Configuration for RimuHosting.
Since: v1.1.0
Configuration for Sakura Cloud.
Since: v3.4.0
Configuration for Scaleway.
Since: v1.2.0
Configuration for Selectel.
Since: v3.4.0
Configuration for Servercow.
Since: v1.1.0
Configuration for Stackpath.
Since: v2.0.0
Configuration for TransIP.
Since: v1.1.0
Configuration for VegaDNS.
Since: v2.7.0
Configuration for Versio.[nl|eu|uk].
Since: v2.0.0
Configuration for Vscale.
Since: v0.3.1
Configuration for Vultr.
Since: v3.7.0
Configuration for Yandex.
Since: v2.1.0
Configuration for Zone.ee.
Since: v3.5.0
Configuration for Zonomi.
Since: v3.7.0
Configuration for deSEC.io.
Since: v3.5.0
Configuration for reg.ru.