lego/docs/content/dns/zz_gen_vkcloud.md

title	date	draft	slug	dnsprovider
VK Cloud	2019-03-03T16:39:46+01:00	false	vkcloud	since code url v4.9.0 vkcloud https://mcs.mail.ru/

Configuration for VK Cloud.

• Code: vkcloud
• Since: v4.9.0

Here is an example bash command using the VK Cloud provider:

VK_CLOUD_PROJECT_ID="<your_project_id>" \
VK_CLOUD_USERNAME="<your_email>" \
VK_CLOUD_PASSWORD="<your_password>" \
lego --email you@example.com --dns vkcloud --domains "example.org" --domains "*.example.org" run

Credentials

Environment Variable Name	Description
VK_CLOUD_PASSWORD	Password for VK Cloud account
VK_CLOUD_PROJECT_ID	String ID of project in VK Cloud
VK_CLOUD_USERNAME	Email of VK Cloud account

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information [here]({{% ref "dns#configuration-and-credentials" %}}).

Additional Configuration

Environment Variable Name	Description
VK_CLOUD_DNS_ENDPOINT	URL of DNS API. Defaults to https://mcs.mail.ru/public-dns but can be changed for usage with private clouds
VK_CLOUD_DOMAIN_NAME	Openstack users domain name. Defaults to users but can be changed for usage with private clouds
VK_CLOUD_IDENTITY_ENDPOINT	URL of OpenStack Auth API, Defaults to https://infra.mail.ru:35357/v3/ but can be changed for usage with private clouds
VK_CLOUD_POLLING_INTERVAL	Time between DNS propagation check
VK_CLOUD_PROPAGATION_TIMEOUT	Maximum waiting time for DNS propagation
VK_CLOUD_TTL	The TTL of the TXT record used for the DNS challenge

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information [here]({{% ref "dns#configuration-and-credentials" %}}).

Credential information

You can find all required and additional information on "Project/Keys" page of your cloud.

ENV Variable	Parameter from page
VK_CLOUD_PROJECT_ID	Project ID
VK_CLOUD_USERNAME	Username
VK_CLOUD_DOMAIN_NAME	User Domain Name
VK_CLOUD_IDENTITY_ENDPOINT	Identity endpoint

More information

• API documentation