chore: prepare v2.0.0-beta.40

This commit is contained in:
Jacky 2024-11-16 12:58:01 +08:00
parent 38d9d08ef0
commit 4ab34fde57
No known key found for this signature in database
GPG key ID: 215C21B10DF38B4D
144 changed files with 569 additions and 249 deletions

View file

@ -8,7 +8,7 @@ Since = "v1.1.0"
Example = '''
ACME_DNS_API_BASE=http://10.0.0.8:4443 \
ACME_DNS_STORAGE_PATH=/root/.lego-acme-dns-accounts.json \
lego --email you@example.com --dns acme-dns --domains my.example.org run
lego --email you@example.com --dns "acme-dns" -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,13 +7,13 @@ Since = "v1.1.0"
Example = '''
# Setup using instance RAM role
ALICLOUD_RAM_ROLE=lego \
lego --email you@example.com --dns alidns --domains my.example.org run
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 --domains my.example.org run
lego --email you@example.com --dns alidns - -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.5.0"
Example = '''
ALL_INKL_LOGIN=xxxxxxxxxxxxxxxxxxxxxxxxxx \
ALL_INKL_PASSWORD=yyyyyyyyyyyyyyyyyyyyyyyyyy \
lego --email you@example.com --dns allinkl --domains my.example.org run
lego --email you@example.com --dns allinkl -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v3.8.0"
Example = '''
ARVANCLOUD_API_KEY="Apikey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
lego --email you@example.com --dns arvancloud --domains my.example.org run
lego --email you@example.com --dns arvancloud -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v0.4.0"
Example = '''
AURORA_API_KEY=xxxxx \
AURORA_SECRET=yyyyyy \
lego --email you@example.com --dns auroradns --domains my.example.org run
lego --email you@example.com --dns auroradns -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v3.2.0"
Example = '''
AUTODNS_API_USER=username \
AUTODNS_API_PASSWORD=supersecretpassword \
lego --email you@example.com --dns autodns --domains my.example.org run
lego --email you@example.com --dns autodns -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -10,32 +10,32 @@ Example = '''
AZURE_CLIENT_ID=<your service principal client ID> \
AZURE_TENANT_ID=<your service principal tenant ID> \
AZURE_CLIENT_SECRET=<your service principal client secret> \
lego --domains example.com --email your_example@email.com --dns azuredns run
lego --email you@example.com --dns azuredns -d '*.example.com' -d example.com run
### Using client certificate
AZURE_CLIENT_ID=<your service principal client ID> \
AZURE_TENANT_ID=<your service principal tenant ID> \
AZURE_CLIENT_CERTIFICATE_PATH=<your service principal certificate path> \
lego --domains example.com --email your_example@email.com --dns azuredns run
lego --email you@example.com --dns azuredns -d '*.example.com' -d example.com run
### Using Azure CLI
az login \
lego --domains example.com --email your_example@email.com --dns azuredns run
lego --email you@example.com --dns azuredns -d '*.example.com' -d example.com run
### Using Managed Identity (Azure VM)
AZURE_TENANT_ID=<your service principal tenant ID> \
AZURE_RESOURCE_GROUP=<your target zone resource group name> \
lego --domains example.com --email your_example@email.com --dns azuredns run
lego --email you@example.com --dns azuredns -d '*.example.com' -d example.com run
### Using Managed Identity (Azure Arc)
AZURE_TENANT_ID=<your service principal tenant ID> \
IMDS_ENDPOINT=http://localhost:40342 \
IDENTITY_ENDPOINT=http://localhost:40342/metadata/identity/oauth2/token \
lego --domains example.com --email your_example@email.com --dns azuredns run
lego --email you@example.com --dns azuredns -d '*.example.com' -d example.com run
'''

View file

@ -6,7 +6,7 @@ Since = "v2.6.0"
Example = '''
BINDMAN_MANAGER_ADDRESS=<your bindman manager address> \
lego --email you@example.com --dns bindman --domains my.example.org run
lego --email you@example.com --dns bindman -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -11,7 +11,7 @@ BLUECAT_USER_NAME=myusername \
BLUECAT_CONFIG_NAME=myconfig \
BLUECAT_SERVER_URL=https://bam.example.com \
BLUECAT_TTL=30 \
lego --email you@example.com --dns bluecat --domains my.example.org run
lego --email you@example.com --dns bluecat -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -1,5 +1,10 @@
Name = "Brandit"
Description = ''''''
Name = "Brandit (deprecated)"
Description = '''
Brandit has been acquired by Abion.
Abion has a different API.
If you are a Brandit/Albion user, you can try the PR https://github.com/go-acme/lego/pull/2112.
'''
URL = "https://www.brandit.com/"
Code = "brandit"
Since = "v4.11.0"
@ -7,7 +12,7 @@ Since = "v4.11.0"
Example = '''
BRANDIT_API_KEY=xxxxxxxxxxxxxxxxxxxxx \
BRANDIT_API_USERNAME=yyyyyyyyyyyyyyyyyyyy \
lego --email myemail@example.com --dns brandit --domains my.example.org run
lego --email you@example.com --dns brandit -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.11.0"
Example = '''
BUNNY_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
lego --email you@example.com --dns bunny --domains my.example.org run
lego --email you@example.com --dns bunny -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v3.3.0"
Example = '''
CHECKDOMAIN_TOKEN=yoursecrettoken \
lego --email you@example.com --dns checkdomain --domains my.example.org run
lego --email you@example.com --dns checkdomain -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.9.0"
Example = '''
CIVO_TOKEN=xxxxxx \
lego --email you@example.com --dns civo --domains my.example.org run
lego --email you@example.com --dns civo -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
CLOUDDNS_CLIENT_ID=bLsdFAks23429841238feb177a572aX \
CLOUDDNS_EMAIL=you@example.com \
CLOUDDNS_PASSWORD=b9841238feb177a84330f \
lego --email you@example.com --dns clouddns --domains my.example.org run
lego --email you@example.com --dns clouddns -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,12 +7,12 @@ Since = "v0.3.0"
Example = '''
CLOUDFLARE_EMAIL=you@example.com \
CLOUDFLARE_API_KEY=b9841238feb177a84330febba8a83208921177bffe733 \
lego --email you@example.com --dns cloudflare --domains my.example.org run
lego --email you@example.com --dns cloudflare -d '*.example.com' -d example.com run
# or
CLOUDFLARE_DNS_API_TOKEN=1234567890abcdefghijklmnopqrstuvwxyz \
lego --email you@example.com --dns cloudflare --domains my.example.org run
lego --email you@example.com --dns cloudflare -d '*.example.com' -d example.com run
'''
Additional = '''
@ -46,12 +46,13 @@ Then pass the API token as `CF_DNS_API_TOKEN` to Lego.
**Alternatively,** if you prefer a more strict set of privileges,
you can split the access tokens:
* Create one with *Zone / Zone / Read* permissions and scope it to all your zones.
* Create one with *Zone / Zone / Read* permissions and scope it to all your zones or just the individual zone you need to edit.
This is needed to resolve domain names to Zone IDs and can be shared among multiple Lego installations.
Pass this API token as `CF_ZONE_API_TOKEN` to Lego.
* Create another API token with *Zone / DNS / Edit* permissions and set the scope to the domains you want to manage with a single Lego installation.
Pass this token as `CF_DNS_API_TOKEN` to Lego.
* Repeat the previous step for each host you want to run Lego on.
* It is possible to use the same api token for both variables if it is given `Zone:Read` and `DNS:Edit` permission for the zone.
This "paranoid" setup is mainly interesting for users who manage many zones/domains with a single Cloudflare account.
It follows the principle of least privilege and limits the possible damage, should one of the hosts become compromised.

View file

@ -7,7 +7,7 @@ Since = "v2.3.0"
Example = '''
CLOUDNS_AUTH_ID=xxxx \
CLOUDNS_AUTH_PASSWORD=yyyy \
lego --email you@example.com --dns cloudns --domains my.example.org run
lego --email you@example.com --dns cloudns -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
CLOUDRU_SERVICE_INSTANCE_ID=ppp \
CLOUDRU_KEY_ID=xxx \
CLOUDRU_SECRET=yyy \
lego --email you@example.com --dns cloudru --domains my.example.org run
lego --email you@example.com --dns cloudru -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -1,13 +1,15 @@
Name = "CloudXNS"
Description = """"""
URL = "https://www.cloudxns.net/"
Name = "CloudXNS (Deprecated)"
Description = '''
The CloudXNS DNS provider has shut down.
'''
URL = "https://github.com/go-acme/lego/issues/2323"
Code = "cloudxns"
Since = "v0.5.0"
Example = '''
CLOUDXNS_API_KEY=xxxx \
CLOUDXNS_SECRET_KEY=yyyy \
lego --email you@example.com --dns cloudxns --domains my.example.org run
lego --email you@example.com --dns cloudxns -d '*.example.com' -d example.com run
'''
[Configuration]
@ -19,6 +21,3 @@ lego --email you@example.com --dns cloudxns --domains my.example.org run
CLOUDXNS_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation"
CLOUDXNS_TTL = "The TTL of the TXT record used for the DNS challenge"
CLOUDXNS_HTTP_TIMEOUT = "API request timeout"
[Links]
API = "https://www.cloudxns.net/Public/Doc/CloudXNS_api2.0_doc_zh-cn.zip"

View file

@ -8,7 +8,7 @@ Example = '''
CONOHA_TENANT_ID=487727e3921d44e3bfe7ebb337bf085e \
CONOHA_API_USERNAME=xxxx \
CONOHA_API_PASSWORD=yyyy \
lego --email you@example.com --dns conoha --domains my.example.org run
lego --email you@example.com --dns conoha -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v3.4.0"
Example = '''
CONSTELLIX_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
CONSTELLIX_SECRET_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
lego --email you@example.com --dns constellix --domains my.example.org run
lego --email you@example.com --dns constellix -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -0,0 +1,25 @@
Name = "Core-Networks"
Description = ''''''
URL = "https://www.core-networks.de/"
Code = "corenetworks"
Since = "v4.20.0"
Example = '''
CORENETWORKS_LOGIN="xxxx" \
CORENETWORKS_PASSWORD="yyyy" \
lego --email you@example.com --dns corenetworks -d '*.example.com' -d example.com run
'''
[Configuration]
[Configuration.Credentials]
CORENETWORKS_LOGIN = "The username of the API account"
CORENETWORKS_PASSWORD = "The password"
[Configuration.Additional]
CORENETWORKS_POLLING_INTERVAL = "Time between DNS propagation check"
CORENETWORKS_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation"
CORENETWORKS_TTL = "The TTL of the TXT record used for the DNS challenge"
CORENETWORKS_HTTP_TIMEOUT = "API request timeout"
CORENETWORKS_SEQUENCE_INTERVAL = "Time between sequential requests"
[Links]
API = "https://beta.api.core-networks.de/doc/"

View file

@ -10,7 +10,7 @@ Example = '''
CPANEL_USERNAME = "yyyy"
CPANEL_TOKEN = "xxxx"
CPANEL_BASE_URL = "https://example.com:2083" \
lego --email you@example.com --dns cpanel --domains my.example.org run
lego --email you@example.com --dns cpanel -d '*.example.com' -d example.com run
## WHM
@ -18,7 +18,7 @@ CPANEL_MODE = whm
CPANEL_USERNAME = "yyyy"
CPANEL_TOKEN = "xxxx"
CPANEL_BASE_URL = "https://example.com:2087" \
lego --email you@example.com --dns cpanel --domains my.example.org run
lego --email you@example.com --dns cpanel -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.12.0"
Example = '''
DERAK_API_KEY="xxxxxxxxxxxxxxxxxxxxx" \
lego --email myemail@example.com --dns derak --domains my.example.org run
lego --email you@example.com --dns derak -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v3.7.0"
Example = '''
DESEC_TOKEN=x-xxxxxxxxxxxxxxxxxxxxxxxxxx \
lego --email you@example.com --dns desec --domains my.example.org run
lego --email you@example.com --dns desec -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v2.2.0"
Example = '''
# With a `clouds.yaml`
OS_CLOUD=my_openstack \
lego --email you@example.com --dns designate --domains my.example.org run
lego --email you@example.com --dns designate -d '*.example.com' -d example.com run
# or
@ -16,7 +16,7 @@ OS_REGION_NAME=RegionOne \
OS_PROJECT_ID=23d4522a987d4ab529f722a007c27846
OS_USERNAME=myuser \
OS_PASSWORD=passw0rd \
lego --email you@example.com --dns designate --domains my.example.org run
lego --email you@example.com --dns designate -d '*.example.com' -d example.com run
# or
@ -25,7 +25,7 @@ OS_REGION_NAME=RegionOne \
OS_AUTH_TYPE=v3applicationcredential \
OS_APPLICATION_CREDENTIAL_ID=imn74uq0or7dyzz20dwo1ytls4me8dry \
OS_APPLICATION_CREDENTIAL_SECRET=68FuSPSdQqkFQYH5X1OoriEIJOwyLtQ8QSqXZOc9XxFK1A9tzZT6He2PfPw0OMja \
lego --email you@example.com --dns designate --domains my.example.org run
lego --email you@example.com --dns designate -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -6,7 +6,7 @@ Since = "v0.3.0"
Example = '''
DO_AUTH_TOKEN=xxxxxx \
lego --email you@example.com --dns digitalocean --domains my.example.org run
lego --email you@example.com --dns digitalocean -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
DIRECTADMIN_API_URL="http://example.com:2222" \
DIRECTADMIN_USERNAME=xxxx \
DIRECTADMIN_PASSWORD=yyy \
lego --email you@example.com --dns directadmin --domains my.example.org run
lego --email you@example.com --dns directadmin -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -5,11 +5,11 @@ Code = "dnshomede"
Since = "v4.10.0"
Example = '''
DNSHOMEDE_CREDENTIALS=sub.example.org:password \
lego --email you@example.com --dns dnshomede --domains example.org --domains '*.example.org' run
DNSHOMEDE_CREDENTIALS=example.org:password \
lego --email you@example.com --dns dnshomede -d '*.example.com' -d example.com run
DNSHOMEDE_CREDENTIALS=my.example.org:password1,demo.example.org:password2 \
lego --email you@example.com --dns dnshomede --domains my.example.org --domains demo.example.org
lego --email you@example.com --dns dnshomede -d my.example.org -d demo.example.org
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v0.3.0"
Example = '''
DNSIMPLE_OAUTH_TOKEN=1234567890abcdefghijklmnopqrstuvwxyz \
lego --email you@example.com --dns dnsimple --domains my.example.org run
lego --email you@example.com --dns dnsimple -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -7,7 +7,7 @@ Since = "v0.4.0"
Example = '''
DNSMADEEASY_API_KEY=xxxxxx \
DNSMADEEASY_API_SECRET=yyyyy \
lego --email you@example.com --dns dnsmadeeasy --domains my.example.org run
lego --email you@example.com --dns dnsmadeeasy -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Since = "v0.4.0"
Example = '''
DNSPOD_API_KEY=xxxxxx \
lego --email you@example.com --dns dnspod --domains my.example.org run
lego --email you@example.com --dns dnspod -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v2.4.0"
Example = '''
DODE_TOKEN=xxxxxx \
lego --email you@example.com --dns dode --domains my.example.org run
lego --email you@example.com --dns dode -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Since = "v4.3.0"
Example = '''
DOMENESHOP_API_TOKEN=<token> \
DOMENESHOP_API_SECRET=<secret> \
lego --email example@example.com --dns domeneshop --domains example.com run
lego --email example@example.com --dns domeneshop -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -6,7 +6,7 @@ Since = "v1.1.0"
Example = '''
DREAMHOST_API_KEY="YOURAPIKEY" \
lego --email you@example.com --dns dreamhost --domains my.example.org run
lego --email you@example.com --dns dreamhost -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v0.5.0"
Example = '''
DUCKDNS_TOKEN=xxxxxx \
lego --email you@example.com --dns duckdns --domains my.example.org run
lego --email you@example.com --dns duckdns -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
DYN_CUSTOMER_NAME=xxxxxx \
DYN_USER_NAME=yyyyy \
DYN_PASSWORD=zzzz \
lego --email you@example.com --dns dyn --domains my.example.org run
lego --email you@example.com --dns dyn -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v3.5.0"
Example = '''
DYNU_API_KEY=1234567890abcdefghijklmnopqrstuvwxyz \
lego --email you@example.com --dns dynu --domains my.example.org run
lego --email you@example.com --dns dynu -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -5,9 +5,9 @@ Code = "easydns"
Since = "v2.6.0"
Example = '''
EASYDNS_TOKEN=<your token> \
EASYDNS_KEY=<your key> \
lego --email you@example.com --dns easydns --domains my.example.org run
EASYDNS_TOKEN=xxx \
EASYDNS_KEY=yyy \
lego --email you@example.com --dns easydns -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -12,7 +12,7 @@ AKAMAI_CLIENT_SECRET=abcdefghijklmnopqrstuvwxyz1234567890ABCDEFG= \
AKAMAI_CLIENT_TOKEN=akab-mnbvcxzlkjhgfdsapoiuytrewq1234567 \
AKAMAI_HOST=akab-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.luna.akamaiapis.net \
AKAMAI_ACCESS_TOKEN=akab-1234567890qwerty-asdfghjklzxcvtnu \
lego --email you@example.com --dns edgedns --domains my.example.org run
lego --email you@example.com --dns edgedns -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -9,7 +9,7 @@ EFFICIENTIP_USERNAME="user" \
EFFICIENTIP_PASSWORD="secret" \
EFFICIENTIP_HOSTNAME="ipam.example.org" \
EFFICIENTIP_DNS_NAME="dns.smart" \
lego --email you@example.com --dns efficientip --domains my.example.org run
lego --email you@example.com --dns efficientip -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.5.0"
Example = '''
EPIK_SIGNATURE=xxxxxxxxxxxxxxxxxxxxxxxxxx \
lego --email you@example.com --dns epik --domains my.example.org run
lego --email you@example.com --dns epik -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v0.5.0"
Example = '''
EXEC_PATH=/the/path/to/myscript.sh \
lego --email you@example.com --dns exec --domains my.example.org run
lego --email you@example.com --dns exec -d '*.example.com' -d example.com run
'''
Additional = '''
@ -39,9 +39,7 @@ For example, requesting a certificate for the domain 'my.example.org' can be ach
```bash
EXEC_PATH=./update-dns.sh \
lego --email you@example.com \
--dns exec \
--domains my.example.org run
lego --email you@example.com --dns exec --d my.example.org run
```
It will then call the program './update-dns.sh' with like this:
@ -61,9 +59,7 @@ If you want to use the raw domain, token, and keyAuth values with your program,
```bash
EXEC_MODE=RAW \
EXEC_PATH=./update-dns.sh \
lego --email you@example.com \
--dns exec \
--domains my.example.org run
lego --email you@example.com --dns exec -d my.example.org run
```
It will then call the program `./update-dns.sh` like this:

View file

@ -7,7 +7,7 @@ Since = "v0.4.0"
Example = '''
EXOSCALE_API_KEY=abcdefghijklmnopqrstuvwx \
EXOSCALE_API_SECRET=xxxxxxx \
lego --email you@example.com --dns exoscale --domains my.example.org run
lego --email you@example.com --dns exoscale -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.5.0"
Example = '''
FREEMYIP_TOKEN=xxxxxx \
lego --email you@example.com --dns freemyip --domains my.example.org run
lego --email you@example.com --dns freemyip -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v0.3.0"
Example = '''
GANDI_API_KEY=abcdefghijklmnopqrstuvwx \
lego --email you@example.com --dns gandi --domains my.example.org run
lego --email you@example.com --dns gandi -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v0.5.0"
Example = '''
GANDIV5_PERSONAL_ACCESS_TOKEN=abcdefghijklmnopqrstuvwx \
lego --email you@example.com --dns gandiv5 --domains my.example.org run
lego --email you@example.com --dns gandiv5 -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -5,12 +5,9 @@ Code = "gcloud"
Since = "v0.3.0"
Example = '''
GCE_PROJECT="gc-project-id" GCE_SERVICE_ACCOUNT_FILE="/path/to/svc/account/file.json" lego \
--email="abc@email.com" \
--domains="example.com" \
--dns="gcloud" \
--path="${HOME}/.lego" \
run
GCE_PROJECT="gc-project-id" \
GCE_SERVICE_ACCOUNT_FILE="/path/to/svc/account/file.json" \
lego --email you@email.com --dns gcloud -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.5.0"
Example = '''
GCORE_PERMANENT_API_TOKEN=xxxxx \
lego --email you@example.com --dns gcore --domains my.example.org run
lego --email you@example.com --dns gcore -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v0.5.0"
Example = '''
GLESYS_API_USER=xxxxx \
GLESYS_API_KEY=yyyyy \
lego --email you@example.com --dns glesys --domains my.example.org run
lego --email you@example.com --dns glesys -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v0.5.0"
Example = '''
GODADDY_API_KEY=xxxxxxxx \
GODADDY_API_SECRET=yyyyyyyy \
lego --email you@example.com --dns godaddy --domains my.example.org run
lego --email you@example.com --dns godaddy -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -6,7 +6,7 @@ Since = "v4.11.0"
Example = '''
GOOGLE_DOMAINS_ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
lego --email you@example.com --dns googledomains --domains my.example.org run
lego --email you@example.com --dns googledomains -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v3.7.0"
Example = '''
HETZNER_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
lego --email you@example.com --dns hetzner --domains my.example.org run
lego --email you@example.com --dns hetzner -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v1.1.0"
Example = '''
HOSTINGDE_API_KEY=xxxxxxxx \
lego --email you@example.com --dns hostingde --domains my.example.org run
lego --email you@example.com --dns hostingde -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.5.0"
Example = '''
HOSTTECH_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxx \
lego --email you@example.com --dns hosttech --domains my.example.org run
lego --email you@example.com --dns hosttech -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.15.0"
Example = '''
HTTPNET_API_KEY=xxxxxxxx \
lego --email you@example.com --dns httpnet --domains my.example.org run
lego --email you@example.com --dns httpnet -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v2.0.0"
Example = '''
HTTPREQ_ENDPOINT=http://my.server.com:9090 \
lego --email you@example.com --dns httpreq --domains my.example.org run
lego --email you@example.com --dns httpreq -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -8,7 +8,7 @@ Example = '''
HUAWEICLOUD_ACCESS_KEY_ID=your-access-key-id \
HUAWEICLOUD_SECRET_ACCESS_KEY=your-secret-access-key \
HUAWEICLOUD_REGION=cn-south-1 \
lego --email you@example.com --dns huaweicloud --domains my.example.org run
lego --email you@example.com --dns huaweicloud -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,10 +6,10 @@ Since = "v4.3.0"
Example = '''
HURRICANE_TOKENS=example.org:token \
lego --email you@example.com --dns hurricane --domains example.org --domains '*.example.org' run
lego --email you@example.com --dns hurricane -d '*.example.com' -d example.com run
HURRICANE_TOKENS=my.example.org:token1,demo.example.org:token2 \
lego --email you@example.com --dns hurricane --domains my.example.org --domains demo.example.org
lego --email you@example.com --dns hurricane -d my.example.org -d demo.example.org
'''
Additional = """

View file

@ -5,7 +5,7 @@ Code = "hyperone"
Since = "v3.9.0"
Example = '''
lego --email you@example.com --dns hyperone --domains my.example.org run
lego --email you@example.com --dns hyperone -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -7,7 +7,7 @@ Since = "v4.5.0"
Example = '''
SOFTLAYER_USERNAME=xxxxx \
SOFTLAYER_API_KEY=yyyyy \
lego --email you@example.com --dns ibmcloud --domains my.example.org run
lego --email you@example.com --dns ibmcloud -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
IIJ_API_ACCESS_KEY=xxxxxxxx \
IIJ_API_SECRET_KEY=yyyyyy \
IIJ_DO_SERVICE_CODE=zzzzzz \
lego --email you@example.com --dns iij --domains my.example.org run
lego --email you@example.com --dns iij -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.7.0"
Example = '''
IIJ_DPF_API_TOKEN=xxxxxxxx \
IIJ_DPF_DPM_SERVICE_CODE=yyyyyy \
lego --email you@example.com --dns iijdpf --domains my.example.org run
lego --email you@example.com --dns iijdpf -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
INFOBLOX_USERNAME=api-user-529 \
INFOBLOX_PASSWORD=b9841238feb177a84330febba8a83208921177bffe733 \
INFOBLOX_HOST=infoblox.example.org
lego --email you@example.com --dns infoblox --domains my.example.org run
lego --email you@example.com --dns infoblox -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -6,7 +6,7 @@ Since = "v4.1.0"
Example = '''
INFOMANIAK_ACCESS_TOKEN=1234567898765432 \
lego --email you@example.com --dns infomaniak --domains my.example.org run
lego --email you@example.com --dns infomaniak -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -7,7 +7,7 @@ Since = "v4.5.0"
Example = '''
INTERNET_BS_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxx \
INTERNET_BS_PASSWORD=yyyyyyyyyyyyyyyyyyyyyyyyyy \
lego --email you@example.com --dns internetbs --domains my.example.org run
lego --email you@example.com --dns internetbs -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,13 +7,13 @@ Since = "v2.0.0"
Example = '''
INWX_USERNAME=xxxxxxxxxx \
INWX_PASSWORD=yyyyyyyyyy \
lego --email you@example.com --dns inwx --domains my.example.org run
lego --email you@example.com --dns inwx -d '*.example.com' -d example.com run
# 2FA
INWX_USERNAME=xxxxxxxxxx \
INWX_PASSWORD=yyyyyyyyyy \
INWX_SHARED_SECRET=zzzzzzzzzz \
lego --email you@example.com --dns inwx --domains my.example.org run
lego --email you@example.com --dns inwx -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.2.0"
Example = '''
IONOS_API_KEY=xxxxxxxx \
lego --email you@example.com --dns ionos --domains my.example.org run
lego --email you@example.com --dns ionos -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.13.0"
Example = '''
IPV64_API_KEY=xxxxxx \
lego --email you@example.com --dns ipv64 --domains my.example.org run
lego --email you@example.com --dns ipv64 -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.7.0"
Example = '''
IWANTMYNAME_USERNAME=xxxxxxxx \
IWANTMYNAME_PASSWORD=xxxxxxxx \
lego --email you@example.com --dns iwantmyname --domains my.example.org run
lego --email you@example.com --dns iwantmyname -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -9,17 +9,17 @@ Example = '''
JOKER_API_MODE=SVC \
JOKER_USERNAME=<your email> \
JOKER_PASSWORD=<your password> \
lego --email you@example.com --dns joker --domains my.example.org run
lego --email you@example.com --dns joker -d '*.example.com' -d example.com run
# DMAPI
JOKER_API_MODE=DMAPI \
JOKER_USERNAME=<your email> \
JOKER_PASSWORD=<your password> \
lego --email you@example.com --dns joker --domains my.example.org run
lego --email you@example.com --dns joker -d '*.example.com' -d example.com run
## or
JOKER_API_MODE=DMAPI \
JOKER_API_KEY=<your API key> \
lego --email you@example.com --dns joker --domains my.example.org run
lego --email you@example.com --dns joker -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -6,7 +6,7 @@ Since = "v4.10.0"
Example = '''
LIARA_API_KEY="xxxxxxxxxxxxxxxxxxxxx" \
lego --email myemail@example.com --dns liara --domains my.example.org run
lego --email you@example.com --dns liara -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.18.0"
Example = '''
LIMACITY_API_KEY="xxxxxxxxxxxxxxxxxxxxx" \
lego --email myemail@example.com --dns limacity --domains my.example.org run
lego --email you@example.com --dns limacity -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v1.1.0"
Example = '''
LINODE_TOKEN=xxxxx \
lego --email you@example.com --dns linode --domains my.example.org run
lego --email you@example.com --dns linode -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v3.1.0"
Example = '''
LWAPI_USERNAME=someuser \
LWAPI_PASSWORD=somepass \
lego --email you@example.com --dns liquidweb --domains my.example.org run
lego --email you@example.com --dns liquidweb -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.2.0"
Example = '''
LOOPIA_API_USER=xxxxxxxx \
LOOPIA_API_PASSWORD=yyyyyyyy \
lego --email my@email.com --dns loopia --domains my.domain.com run
lego --email you@example.com --dns loopia -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -7,7 +7,7 @@ Since = "v3.7.0"
Example = '''
LUADNS_API_USERNAME=youremail \
LUADNS_API_TOKEN=xxxxxxxx \
lego --email you@example.com --dns luadns --domains my.example.org run
lego --email you@example.com --dns luadns -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
MAILINABOX_EMAIL=user@example.com \
MAILINABOX_PASSWORD=yyyy \
MAILINABOX_BASE_URL=https://box.example.com \
lego --email you@example.com --dns mailinabox --domains my.example.org run
lego --email you@example.com --dns mailinabox -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.13.0"
Example = '''
METANAME_ACCOUNT_REFERENCE=xxxx \
METANAME_API_KEY=yyyyyyy \
lego --email you@example.com --dns metaname --domains my.example.org run
lego --email you@example.com --dns metaname -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.18.0"
Example = '''
MIJNHOST_API_KEY="xxxxxxxxxxxxxxxxxxxxx" \
lego --email myemail@example.com --dns mijnhost --domains my.example.org run
lego --email you@example.com --dns mijnhost -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v1.48.0"
Example = '''
MITTWALD_TOKEN=my-token \
lego --email you@example.com --dns mittwald --domains my.example.org run
lego --email you@example.com --dns mittwald -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v1.2.0"
Example = '''
MYDNSJP_MASTER_ID=xxxxx \
MYDNSJP_PASSWORD=xxxxx \
lego --email you@example.com --dns mydnsjp --domains my.example.org run
lego --email you@example.com --dns mydnsjp -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v0.3.7"
Example = '''
MYTHICBEASTS_USERNAME=myuser \
MYTHICBEASTS_PASSWORD=mypass \
lego --email you@example.com --dns mythicbeasts --domains my.example.org run
lego --email you@example.com --dns mythicbeasts -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -14,7 +14,7 @@ More information in the section [Enabling API Access](https://www.namecheap.com/
Example = '''
NAMECHEAP_API_USER=user \
NAMECHEAP_API_KEY=key \
lego --email you@example.com --dns namecheap --domains my.example.org run
lego --email you@example.com --dns namecheap -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v0.5.0"
Example = '''
NAMECOM_USERNAME=foo.bar \
NAMECOM_API_TOKEN=a379a6f6eeafb9a55e378c118034e2751e682fab \
lego --email you@example.com --dns namedotcom --domains my.example.org run
lego --email you@example.com --dns namedotcom -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v2.7.0"
Example = '''
NAMESILO_API_KEY=b9841238feb177a84330febba8a83208921177bffe733 \
lego --email you@example.com --dns namesilo --domains my.example.org run
lego --email you@example.com --dns namesilo -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.8.0"
Example = '''
NEARLYFREESPEECH_API_KEY=xxxxxx \
NEARLYFREESPEECH_LOGIN=xxxx \
lego --email you@example.com --dns nearlyfreespeech --domains my.example.org run
lego --email you@example.com --dns nearlyfreespeech -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -8,7 +8,7 @@ Example = '''
NETCUP_CUSTOMER_NUMBER=xxxx \
NETCUP_API_KEY=yyyy \
NETCUP_API_PASSWORD=zzzz \
lego --email you@example.com --dns netcup --domains my.example.org run
lego --email you@example.com --dns netcup -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v3.7.0"
Example = '''
NETLIFY_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
lego --email you@example.com --dns netlify --domains my.example.org run
lego --email you@example.com --dns netlify -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -13,7 +13,7 @@ NICMANAGER_API_PASSWORD = "password" \
# Optionally, if your account has TOTP enabled, set the secret here
NICMANAGER_API_OTP = "long-secret" \
lego --email you@example.com --dns nicmanager --domains my.example.org run
lego --email you@example.com --dns nicmanager -d '*.example.com' -d example.com run
## Login using account name + username
@ -24,7 +24,7 @@ NICMANAGER_API_PASSWORD = "password" \
# Optionally, if your account has TOTP enabled, set the secret here
NICMANAGER_API_OTP = "long-secret" \
lego --email you@example.com --dns nicmanager --domains my.example.org run
lego --email you@example.com --dns nicmanager -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -7,7 +7,7 @@ Since = "v1.1.0"
Example = '''
NIFCLOUD_ACCESS_KEY_ID=xxxx \
NIFCLOUD_SECRET_ACCESS_KEY=yyyy \
lego --email you@example.com --dns nifcloud --domains my.example.org run
lego --email you@example.com --dns nifcloud -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.3.0"
Example = '''
NJALLA_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxx \
lego --email you@example.com --dns njalla --domains my.example.org run
lego --email you@example.com --dns njalla -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.11.0"
Example = '''
NODION_API_TOKEN="xxxxxxxxxxxxxxxxxxxxx" \
lego --email myemail@example.com --dns nodion --domains my.example.org run
lego --email you@example.com --dns nodion -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v0.4.0"
Example = '''
NS1_API_KEY=xxxx \
lego --email you@example.com --dns ns1 --domains my.example.org run
lego --email you@example.com --dns ns1 -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -12,7 +12,7 @@ OCI_USER_OCID="ocid1.user.oc1..secret" \
OCI_PUBKEY_FINGERPRINT="00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00" \
OCI_REGION="us-phoenix-1" \
OCI_COMPARTMENT_OCID="ocid1.tenancy.oc1..secret" \
lego --email you@example.com --dns oraclecloud --domains my.example.org run
lego --email you@example.com --dns oraclecloud -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -11,20 +11,20 @@ OVH_APPLICATION_KEY=1234567898765432 \
OVH_APPLICATION_SECRET=b9841238feb177a84330febba8a832089 \
OVH_CONSUMER_KEY=256vfsd347245sdfg \
OVH_ENDPOINT=ovh-eu \
lego --email you@example.com --dns ovh --domains my.example.org run
lego --email you@example.com --dns ovh -d '*.example.com' -d example.com run
# Or Access Token:
OVH_ACCESS_TOKEN=xxx \
OVH_ENDPOINT=ovh-eu \
lego --email you@example.com --dns ovh --domains my.example.org run
lego --email you@example.com --dns ovh -d '*.example.com' -d example.com run
# Or OAuth2:
OVH_CLIENT_ID=yyy \
OVH_CLIENT_SECRET=xxx \
OVH_ENDPOINT=ovh-eu \
lego --email you@example.com --dns ovh --domains my.example.org run
lego --email you@example.com --dns ovh -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -7,7 +7,7 @@ Since = "v0.4.0"
Example = '''
PDNS_API_URL=http://pdns-server:80/ \
PDNS_API_KEY=xxxx \
lego --email you@example.com --dns pdns --domains my.example.org run
lego --email you@example.com --dns pdns -d '*.example.com' -d example.com run
'''
Additional = '''

View file

@ -8,7 +8,7 @@ Example = '''
PLESK_SERVER_BASE_URL="https://plesk.myserver.com:8443" \
PLESK_USERNAME=xxxxxx \
PLESK_PASSWORD=yyyyyy \
lego --email you@example.com --dns plesk --domains my.example.org run
lego --email you@example.com --dns plesk -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v4.4.0"
Example = '''
PORKBUN_SECRET_API_KEY=xxxxxx \
PORKBUN_API_KEY=yyyyyy \
lego --email you@example.com --dns porkbun --domains my.example.org run
lego --email you@example.com --dns porkbun -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -7,7 +7,7 @@ Since = "v0.4.0"
Example = '''
RACKSPACE_USER=xxxx \
RACKSPACE_API_KEY=yyyy \
lego --email you@example.com --dns rackspace --domains my.example.org run
lego --email you@example.com --dns rackspace -d '*.example.com' -d example.com run
'''
[Configuration]

View file

@ -6,7 +6,7 @@ Since = "v4.13"
Example = '''
RCODEZERO_API_TOKEN=<mytoken> \
lego --email you@example.com --dns rcodezero --domains my.example.org run
lego --email you@example.com --dns rcodezero -d '*.example.com' -d example.com run
'''
Additional = '''

Some files were not shown because too many files have changed in this diff Show more