lego/docs/content/dns/zz_gen_nicmanager.md
Jens L d2e526e8dd
Add DNS provider for nicmanager (#1473)
Co-authored-by: Fernandez Ludovic <ldez@users.noreply.github.com>
2021-08-27 12:47:28 +02:00

2.7 KiB

title date draft slug
Nicmanager 2019-03-03T16:39:46+01:00 false nicmanager

Since: v4.5.0

Configuration for Nicmanager.

  • Code: nicmanager

Here is an example bash command using the Nicmanager provider:

## Login using email

NICMANAGER_API_EMAIL = "foo@bar.baz" \
NICMANAGER_API_PASSWORD = "password" \

# Optionally, if your account has TOTP enabled, set the secret here
NICMANAGER_API_OTP = "long-secret" \

lego --email myemail@example.com --dns nicmanager --domains my.example.org run

## Login using account name + username

NICMANAGER_API_LOGIN = "myaccount" \
NICMANAGER_API_USERNAME = "myuser" \
NICMANAGER_API_PASSWORD = "password" \

# Optionally, if your account has TOTP enabled, set the secret here
NICMANAGER_API_OTP = "long-secret" \

lego --email myemail@example.com --dns nicmanager --domains my.example.org run

Credentials

Environment Variable Name Description
NICMANAGER_API_EMAIL Email-based login
NICMANAGER_API_LOGIN Login, used for Username-based login
NICMANAGER_API_PASSWORD Password, always required
NICMANAGER_API_USERNAME Username, used for Username-based login

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
NICMANAGER_API_MODE mode: 'anycast' or 'zone' (default: 'anycast')
NICMANAGER_API_OTP TOTP Secret (optional)
NICMANAGER_HTTP_TIMEOUT API request timeout
NICMANAGER_POLLING_INTERVAL Time between DNS propagation check
NICMANAGER_PROPAGATION_TIMEOUT Maximum waiting time for DNS propagation
NICMANAGER_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.

Description

You can login using your account name + username or using your email address. Optionally if TOTP is configured for your account, set NICMANAGER_API_OTP.

More information