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 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.
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 runDNS 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 |
| Axelname | Website |
axelname
|
v4.23.0 |
| Azion | Website |
azion
|
v4.24.0 |
| Azure (deprecated) | Website |
azure
|
v0.4.0 |
| Azure DNS | Website |
azuredns
|
v4.13.0 |
| Baidu Cloud | Website |
baiducloud
|
v4.23.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 v2 | Website |
conoha
|
v1.2.0 |
| ConoHa v3 | Website |
conohav3
|
v4.24.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 |
| DynDnsFree.de | Website |
dyndnsfree
|
v4.23.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 |
| RU CENTER | Website |
nicru
|
v4.24.0 |
| 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 |