DNS Providers :: Let’s Encrypt client and ACME library written in Go.
Author: Lego Team
Description: Configuration and Credentials Credentials and DNS configuration for DNS providers must be passed through environment variables. Environment Variables: Value The environment variables can reference a value. Here is an example bash command using the Cloudflare DNS provider: $ CLOUDFLARE_EMAIL=you@example.com \ CLOUDFLARE_API_KEY=b9841238feb177a84330febba8a83208921177bffe733 \ lego --dns cloudflare --domains www.example.com --email you@example.com runEnvironment Variables: File The environment variables can reference a path to file. In this case the name of environment variable must be suffixed by _FILE.

# DNS Providers

## Configuration and Credentials

Credentials and DNS configuration for DNS providers must be passed through environment variables.

### Environment Variables: Value

The environment variables can reference a value.

Here is an example bash command using the Cloudflare DNS provider:

    $ CLOUDFLARE_EMAIL=you@example.com \
      CLOUDFLARE_API_KEY=b9841238feb177a84330febba8a83208921177bffe733 \
      lego --dns cloudflare --domains www.example.com --email you@example.com run

### Environment Variables: File

The environment variables can reference a path to file.

In this case the name of environment variable must be suffixed by `_FILE`.

Note

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
    you@example.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 you@example.com run

## DNS Providers

Provider name | CLI flag name | Required lego version
--- | --- | ---
Active24 | Website | `active24` | v4.23.0
Akamai EdgeDNS | Website | `edgedns` | v3.9.0
Alibaba Cloud DNS | Website | `alidns` | v1.1.0
all-inkl | Website | `allinkl` | v4.5.0
Amazon Lightsail | Website | `lightsail` | v0.5.0
Amazon Route 53 | Website | `route53` | v0.3.0
ArvanCloud | Website | `arvancloud` | v3.8.0
Aurora DNS | Website | `auroradns` | v0.4.0
Autodns | Website | `autodns` | v3.2.0
Azure (deprecated) | Website | `azure` | v0.4.0
Azure DNS | Website | `azuredns` | v4.13.0
Bindman | Website | `bindman` | v2.6.0
Bluecat | Website | `bluecat` | v0.5.0
BookMyName | Website | `bookmyname` | v4.23.0
Brandit (deprecated) | Website | `brandit` | v4.11.0
Bunny | Website | `bunny` | v4.11.0
Checkdomain | Website | `checkdomain` | v3.3.0
Civo | Website | `civo` | v4.9.0
Cloud.ru | Website | `cloudru` | v4.14.0
CloudDNS | Website | `clouddns` | v3.6.0
Cloudflare | Website | `cloudflare` | v0.3.0
ClouDNS | Website | `cloudns` | v2.3.0
CloudXNS (Deprecated) | Website | `cloudxns` | v0.5.0
ConoHa | Website | `conoha` | v1.2.0
Constellix | Website | `constellix` | v3.4.0
Core-Networks | Website | `corenetworks` | v4.20.0
CPanel/WHM | Website | `cpanel` | v4.16.0
Derak Cloud | Website | `derak` | v4.12.0
deSEC.io | Website | `desec` | v3.7.0
Designate DNSaaS for Openstack | Website | `designate` | v2.2.0
Digital Ocean | Website | `digitalocean` | v0.3.0
DirectAdmin | Website | `directadmin` | v4.18.0
DNS Made Easy | Website | `dnsmadeeasy` | v0.4.0
dnsHome.de | Website | `dnshomede` | v4.10.0
DNSimple | Website | `dnsimple` | v0.3.0
DNSPod (deprecated) | Website | `dnspod` | v0.4.0
Domain Offensive (do.de) | Website | `dode` | v2.4.0
Domeneshop | Website | `domeneshop` | v4.3.0
DreamHost | Website | `dreamhost` | v1.1.0
Duck DNS | Website | `duckdns` | v0.5.0
Dyn | Website | `dyn` | v0.3.0
Dynu | Website | `dynu` | v3.5.0
EasyDNS | Website | `easydns` | v2.6.0
Efficient IP | Website | `efficientip` | v4.13.0
Epik | Website | `epik` | v4.5.0
Exoscale | Website | `exoscale` | v0.4.0
External program | Website | `exec` | v0.5.0
F5 XC | Website | `f5xc` | v4.23.0
freemyip.com | Website | `freemyip` | v4.5.0
G-Core | Website | `gcore` | v4.5.0
Gandi | Website | `gandi` | v0.3.0
Gandi Live DNS (v5) | Website | `gandiv5` | v0.5.0
Glesys | Website | `glesys` | v0.5.0
Go Daddy | Website | `godaddy` | v0.5.0
Google Cloud | Website | `gcloud` | v0.3.0
Google Domains | Website | `googledomains` | v4.11.0
Hetzner | Website | `hetzner` | v3.7.0
Hosting.de | Website | `hostingde` | v1.1.0
Hosttech | Website | `hosttech` | v4.5.0
HTTP request | Website | `httpreq` | v2.0.0
http.net | Website | `httpnet` | v4.15.0
Huawei Cloud | Website | `huaweicloud` | v4.19
Hurricane Electric DNS | Website | `hurricane` | v4.3.0
HyperOne | Website | `hyperone` | v3.9.0
IBM Cloud (SoftLayer) | Website | `ibmcloud` | v4.5.0
IIJ DNS Platform Service | Website | `iijdpf` | v4.7.0
Infoblox | Website | `infoblox` | v4.4.0
Infomaniak | Website | `infomaniak` | v4.1.0
Internet Initiative Japan | Website | `iij` | v1.1.0
Internet.bs | Website | `internetbs` | v4.5.0
INWX | Website | `inwx` | v2.0.0
Ionos | Website | `ionos` | v4.2.0
IPv64 | Website | `ipv64` | v4.13.0
iwantmyname | Website | `iwantmyname` | v4.7.0
Joker | Website | `joker` | v2.6.0
Joohoi's ACME-DNS | Website | `acme-dns` | v1.1.0
Liara | Website | `liara` | v4.10.0
Lima-City | Website | `limacity` | v4.18.0
Linode (v4) | Website | `linode` | v1.1.0
Liquid Web | Website | `liquidweb` | v3.1.0
Loopia | Website | `loopia` | v4.2.0
LuaDNS | Website | `luadns` | v3.7.0
Mail-in-a-Box | Website | `mailinabox` | v4.16.0
ManageEngine CloudDNS | Website | `manageengine` | v4.21.0
Manual |  | `manual` | v0.3.0
Metaname | Website | `metaname` | v4.13.0
Metaregistrar | Website | `metaregistrar` | v4.23.0
mijn.host | Website | `mijnhost` | v4.18.0
Mittwald | Website | `mittwald` | v1.48.0
myaddr.{tools,dev,io} | Website | `myaddr` | v4.22.0
MyDNS.jp | Website | `mydnsjp` | v1.2.0
MythicBeasts | Website | `mythicbeasts` | v0.3.7
Name.com | Website | `namedotcom` | v0.5.0
Namecheap | Website | `namecheap` | v0.3.0
Namesilo | Website | `namesilo` | v2.7.0
NearlyFreeSpeech.NET | Website | `nearlyfreespeech` | v4.8.0
Netcup | Website | `netcup` | v1.1.0
Netlify | Website | `netlify` | v3.7.0
Nicmanager | Website | `nicmanager` | v4.5.0
NIFCloud | Website | `nifcloud` | v1.1.0
Njalla | Website | `njalla` | v4.3.0
Nodion | Website | `nodion` | v4.11.0
NS1 | Website | `ns1` | v0.4.0
Open Telekom Cloud | Website | `otc` | v0.4.1
Oracle Cloud | Website | `oraclecloud` | v2.3.0
OVH | Website | `ovh` | v0.4.0
plesk.com | Website | `plesk` | v4.11.0
Porkbun | Website | `porkbun` | v4.4.0
PowerDNS | Website | `pdns` | v0.4.0
Rackspace | Website | `rackspace` | v0.4.0
Rain Yun/雨云 | Website | `rainyun` | v4.21.0
RcodeZero | Website | `rcodezero` | v4.13
reg.ru | Website | `regru` | v3.5.0
Regfish | Website | `regfish` | v4.20.0
RFC2136 | Website | `rfc2136` | v0.3.0
RimuHosting | Website | `rimuhosting` | v0.3.5
Sakura Cloud | Website | `sakuracloud` | v1.1.0
Scaleway | Website | `scaleway` | v3.4.0
Selectel | Website | `selectel` | v1.2.0
Selectel v2 | Website | `selectelv2` | v4.17.0
SelfHost.(de|eu) | Website | `selfhostde` | v4.19.0
Servercow | Website | `servercow` | v3.4.0
Shellrent | Website | `shellrent` | v4.16.0
Simply.com | Website | `simply` | v4.4.0
Sonic | Website | `sonic` | v4.4.0
Spaceship | Website | `spaceship` | v4.22.0
Stackpath | Website | `stackpath` | v1.1.0
Technitium | Website | `technitium` | v4.20.0
Tencent Cloud DNS | Website | `tencentcloud` | v4.6.0
Timeweb Cloud | Website | `timewebcloud` | v4.20.0
TransIP | Website | `transip` | v2.0.0
UKFast SafeDNS | Website | `safedns` | v4.6.0
Ultradns | Website | `ultradns` | v4.10.0
Variomedia | Website | `variomedia` | v4.8.0
VegaDNS | Website | `vegadns` | v1.1.0
Vercel | Website | `vercel` | v4.7.0
Versio.[nl|eu|uk] | Website | `versio` | v2.7.0
VinylDNS | Website | `vinyldns` | v4.4.0
VK Cloud | Website | `vkcloud` | v4.9.0
Volcano Engine/火山引擎 | Website | `volcengine` | v4.19.0
Vscale | Website | `vscale` | v2.0.0
Vultr | Website | `vultr` | v0.3.1
Webnames | Website | `webnames` | v4.15.0
Websupport | Website | `websupport` | v4.10.0
WEDOS | Website | `wedos` | v4.4.0
West.cn/西部数码 | Website | `westcn` | v4.21.0
Yandex 360 | Website | `yandex360` | v4.14.0
Yandex Cloud | Website | `yandexcloud` | v4.9.0
Yandex PDD | Website | `yandex` | v3.7.0
Zone.ee | Website | `zoneee` | v2.1.0
Zonomi | Website | `zonomi` | v3.5.0