docs/content/dns/zz_gen_joker.md
Configuration for Joker.
<!--more-->jokerHere is an example bash command using the Joker provider:
# SVC
JOKER_API_MODE=SVC \
JOKER_USERNAME=<your email> \
JOKER_PASSWORD=<your password> \
lego --dns joker -d '*.example.com' -d example.com run
# DMAPI
JOKER_API_MODE=DMAPI \
JOKER_USERNAME=<your email> \
JOKER_PASSWORD=<your password> \
lego --dns joker -d '*.example.com' -d example.com run
## or
JOKER_API_MODE=DMAPI \
JOKER_API_KEY=<your API key> \
lego --dns joker -d '*.example.com' -d example.com run
| Environment Variable Name | Description |
|---|---|
JOKER_API_KEY | API key (only with DMAPI mode) |
JOKER_API_MODE | 'DMAPI' or 'SVC'. DMAPI is for resellers accounts. (Default: DMAPI) |
JOKER_PASSWORD | Joker.com password |
JOKER_USERNAME | Joker.com username |
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" %}}).
| Environment Variable Name | Description |
|---|---|
JOKER_HTTP_TIMEOUT | API request timeout in seconds (Default: 60) |
JOKER_POLLING_INTERVAL | Time between DNS propagation check in seconds (Default: 2) |
JOKER_PROPAGATION_TIMEOUT | Maximum waiting time for DNS propagation in seconds (Default: 120) |
JOKER_SEQUENCE_INTERVAL | Time between sequential requests in seconds (Default: 60), only with 'SVC' mode |
JOKER_TTL | The TTL of the TXT record used for the DNS challenge in seconds (Default: 120) |
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" %}}).
In the SVC mode, username and passsword are not your email and account passwords, but those displayed in Joker.com domain dashboard when enabling Dynamic DNS.
As per Joker.com documentation:
please log in at Joker.com, visit 'My Domains', find the domain you want to add Let's Encrypt certificate for, and chose "DNS" in the menu
on the top right, you will find the setting for 'Dynamic DNS'. If not already active, please activate it. It will not affect any other already existing DNS records of this domain.
please take a note of the credentials which are now shown as 'Dynamic DNS Authentication', consisting of a 'username' and a 'password'.
this is all you have to do here - and only once per domain.