generate-letsencrypt-cert

Requests and installs a Let’s Encrypt cert for a virtual server The server must be specified with the --domain flag, followed by a domain name. By default the certificate will be the for either previously used hostnames for Let’s Encrypt, or the default SSL hostnames for the domain. However, you can specify an alternate list of hostnames with the --host flag, which can be given multiple times. Or you can force use of the default SSL hostname list with --default-hosts.

Requests and installs a Let’s Encrypt cert for a virtual server#

The server must be specified with the --domain flag, followed by a domain name. By default the certificate will be the for either previously used hostnames for Let’s Encrypt, or the default SSL hostnames for the domain. However, you can specify an alternate list of hostnames with the --host flag, which can be given multiple times. Or you can force use of the default SSL hostname list with --default-hosts.

If the optional --renew flag is given, automatic renewal will be configured to occur when the certificate is close to expiry.

To have Virtualmin attempt to verify external Internet connectivity to your domain before requesting the certificate, use the --check-first flag. This will detect common errors before your Let’s Encrypt service quota is consumed.

To have Virtualmin perform a local validation check of the domain, use the --validate-first flag. This is automatically enabled when --check-first is set.

By default, the standard Let’s Encrypt service will be used. However, you can use a different ACME-compatible provider with the --server flag followed by the provider’s API URL. The --server-key and --server-hmac flags can be used to specify a login to the provider.

By default Virtualmin will attempt to perform an external DNS lookup of all domain names that the certificate is requested for, to make sure they can be resolved by the Let’s Encrypt service. To disable this check, use the --skip-dns-check flag. Or to forcible enable it because it was disabled for the domain in the UI, use the --dns-check flag.

By default both web and DNS validation will be attempted by Let’s Encrypt for domain ownership, but you can select just one with either the --web or --dns flags.

Command line help#

virtualmin generate-letsencrypt-cert --domain name
 [--host hostname]*
 [--default-hosts]
 [--renew]
 [--size bits]
 [--staging]
 [--check-first | --validate-first]
 [--web | --dns]
 [--rsa | --ec]
 [--server url]
 [--server-key id]
 [--server-hmac string]

Source: https://www.virtualmin.com/docs/development/api-programs/generate-letsencrypt-cert/

  • virtualmin, domain, dns, ssl, certificate, letsencrypt, quota, log, install, api, command line, error, resolve, generate, cert
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Pre and Post Domain Modification Scripts

Virtualmin allows the use of custom scripts (Shell, Perl, Python and etc.) to automate tasks...

OS Support

Virtualmin runs on top of Webmin. Webmin works on almost every UNIX-like OS, so with some manual...

Professional Features

Virtualmin GPL is already an extremely powerful and flexible virtual hosting control panel, so...

How to Configure Secondary DNS

This guide provides administrators with a quick overview of setting up automatic DNS secondary...

How to Configure Cloudflare DNS

For users looking to integrate Cloudflare with Virtualmin Pro, the process is straightforward and...