docs: clarify --dry-run documentation (#9683)

* remove pointless paragraph about --server and wildcards

* docs: update help text for --dry-run and --staging

* docs: update "Changing the ACME Server" for --dry-run

* add note about webserver reloads
This commit is contained in:
alexzorin
2023-04-25 16:43:18 -07:00
committed by GitHub
parent 67f14f177b
commit 10fba2ee3f
2 changed files with 16 additions and 19 deletions
+7 -7
View File
@@ -1091,19 +1091,19 @@ ACME directory. For example, if you would like to use Let's Encrypt's
staging server, you would add ``--server
https://acme-staging-v02.api.letsencrypt.org/directory`` to the command line.
.. note:: ``--dry-run`` uses the Let's Encrypt staging server, unless ``--server``
is specified on the CLI or in the :ref:`cli.ini configuration file <config-file>`.
Take caution when using ``--dry-run`` with a custom server, as it may cause real
certificates to be issued and discarded.
If Certbot does not trust the SSL certificate used by the ACME server, you
can use the `REQUESTS_CA_BUNDLE
<https://requests.readthedocs.io/en/latest/user/advanced/#ssl-cert-verification>`_
environment variable to override the root certificates trusted by Certbot. Certbot
uses the ``requests`` library, which does not use the operating system trusted root store.
Make sure that ``REQUESTS_CA_BUNDLE`` is set globally in the environment and not only on
the CLI, or scheduled renewal will not succeed.
If you use ``--server`` to specify an ACME CA that implements the standardized
version of the spec, you may be able to obtain a certificate for a
wildcard domain. Some CAs (such as Let's Encrypt) require that domain
validation for wildcard domains must be done through modifications to
DNS records which means that the dns-01_ challenge type must be used. To
see a list of Certbot plugins that support this challenge type and how
to use them, see plugins_.
Lock Files
==========