2019-03-08 20:47:06 +02:00
|
|
|
---
|
|
|
|
title: "DNS Providers"
|
|
|
|
date: 2019-03-03T16:39:46+01:00
|
|
|
|
draft: false
|
|
|
|
weight: 3
|
|
|
|
---
|
|
|
|
|
2019-03-18 18:42:54 +02:00
|
|
|
## 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.
|
2019-03-08 20:47:06 +02:00
|
|
|
|
2020-09-30 00:27:08 +02:00
|
|
|
Here is an example bash command using the Cloudflare DNS provider:
|
2019-03-08 20:47:06 +02:00
|
|
|
|
|
|
|
```bash
|
2019-03-18 18:42:54 +02:00
|
|
|
$ CLOUDFLARE_EMAIL=foo@bar.com \
|
2019-03-08 20:47:06 +02:00
|
|
|
CLOUDFLARE_API_KEY=b9841238feb177a84330febba8a83208921177bffe733 \
|
|
|
|
lego --dns cloudflare --domains www.example.com --email me@bar.com run
|
|
|
|
```
|
|
|
|
|
2019-03-18 18:42:54 +02:00
|
|
|
### 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`.
|
|
|
|
|
|
|
|
{{% notice note %}}
|
|
|
|
The file must contain only the value.
|
|
|
|
{{% /notice %}}
|
|
|
|
|
|
|
|
Here is an example bash command using the CloudFlare DNS provider:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ cat /the/path/to/my/key
|
|
|
|
b9841238feb177a84330febba8a83208921177bffe733
|
|
|
|
|
|
|
|
$ cat /the/path/to/my/email
|
|
|
|
foo@bar.com
|
|
|
|
|
|
|
|
$ CLOUDFLARE_EMAIL_FILE=/the/path/to/my/email \
|
2020-06-07 12:33:35 +02:00
|
|
|
CLOUDFLARE_API_KEY_FILE=/the/path/to/my/key \
|
2019-03-18 18:42:54 +02:00
|
|
|
lego --dns cloudflare --domains www.example.com --email me@bar.com run
|
|
|
|
```
|
|
|
|
|
|
|
|
## Experimental Features
|
|
|
|
|
|
|
|
To resolve CNAME when creating dns-01 challenge:
|
|
|
|
set `LEGO_EXPERIMENTAL_CNAME_SUPPORT` to `true`.
|
|
|
|
|
|
|
|
## DNS Providers
|
|
|
|
|
2019-03-08 20:47:06 +02:00
|
|
|
{{%children style="h2" description="true" %}}
|