Alibaba Cloud DNS

Code: alidns
Since: v1.1.0

Here is an example bash command using the Alibaba Cloud DNS provider:

# Setup using instance RAM role
ALICLOUD_RAM_ROLE=lego \
lego --email you@example.com --dns alidns -d '*.example.com' -d example.com run

# Or, using credentials
ALICLOUD_ACCESS_KEY=abcdefghijklmnopqrstuvwx \
ALICLOUD_SECRET_KEY=your-secret-key \
ALICLOUD_SECURITY_TOKEN=your-sts-token \
lego --email you@example.com --dns alidns - -d '*.example.com' -d example.com run

Credentials

Environment Variable Name	Description
`ALICLOUD_ACCESS_KEY`	Access key ID
`ALICLOUD_RAM_ROLE`	Your instance RAM role (https://www.alibabacloud.com/help/en/ecs/user-guide/attach-an-instance-ram-role-to-an-ecs-instance)
`ALICLOUD_SECRET_KEY`	Access Key secret
`ALICLOUD_SECURITY_TOKEN`	STS Security Token (optional)

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information here.

Additional Configuration

Environment Variable Name	Description
`ALICLOUD_HTTP_TIMEOUT`	API request timeout in seconds (Default: 10)
`ALICLOUD_POLLING_INTERVAL`	Time between DNS propagation check in seconds (Default: 2)
`ALICLOUD_PROPAGATION_TIMEOUT`	Maximum waiting time for DNS propagation in seconds (Default: 60)
`ALICLOUD_TTL`	The TTL of the TXT record used for the DNS challenge in seconds (Default: 600)

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information here.