upstream/certbot
1
0
Fork 0
mirror of https://github.com/certbot/certbot.git synced 2026-06-08 00:02:14 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Clarifications to Docker, certbot-auto content reflecting first three questions in my comment https://github.com/certbot/certbot/pull/3232#issuecomment-231154320

Browse source
This commit is contained in:
Peter 2016-07-07 17:24:58 -07:00
parent 031b41a585
commit c92a1cd182
1 changed files with 22 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

33
docs/using.rst
View file

@ -8,14 +8,16 @@ User Guide
Getting Certbot
===============
To get specific instructions for installing Certbot on your OS, we recommend
visiting certbot.eff.org_. If you're offline, you can find some general
To get specific instructions for installing Certbot on your OS,
visit certbot.eff.org_. This is the easiest way to install Certbot.
If you're offline, or if your webserver or OS are not in the menu, you can find some general
instructions `in the README / Introduction <intro.html#installation>`__
__ installation_
.. _certbot.eff.org: https://certbot.eff.org
.. _certbot-auto:
.. _certbot-auto: https://certbot.eff.org/docs/using.html#certbot-auto
The name of the certbot command
-------------------------------
@ -394,7 +396,12 @@ Running with Docker
Docker_ is an amazingly simple and quick way to obtain a
certificate. However, this mode of operation is unable to install
certificates or configure your webserver, because our installer
plugins cannot reach it from inside the Docker container.
plugins cannot reach your webserver from inside the Docker container.
Most users should use the operating system packages (available from
certbot.eff.org_) or, as a fallback, ``certbot-auto``. You should only
use Docker if you are sure you know what you are doing and have a
good reason to do so.
You should definitely read the :ref:`where-certs` section, in order to
know how to manage the certs
@ -415,9 +422,13 @@ to, `install Docker`_, then issue the following command:
-v "/var/lib/letsencrypt:/var/lib/letsencrypt" \
quay.io/letsencrypt/letsencrypt:latest auth
and follow the instructions (note that ``auth`` command is explicitly
used - no installer plugins involved). Your new cert will be available
in ``/etc/letsencrypt/live`` on the host.
Certbot will obtain a certificate and place it in the directory
``/etc/letsencrypt/live`` on your system and display further instructions
for installing the certificates. You must use the ``auth`` command
to install the certificates instead of plug-ins for this method.
For more information about the layout
of the ``/etc/letsencrypt`` directory, see :ref:`where-certs`.
.. _Docker: https://docker.com
.. _`install Docker`: https://docs.docker.com/userguide/
@ -543,10 +554,10 @@ whole process is described in the :doc:`contributing`.
Comparison of different methods
-------------------------------
Unless you have a very specific requirements, we kindly suggest that you use
the certbot-auto_ method. It's the fastest, the most thoroughly
tested and the most reliable way of getting our software and the free
TLS/SSL certificates!
Unless you have very specific requirements, we kindly suggest that you use
the Certbot packages provided by your package manager (see certbot.eff.org_).
If such packages are not available, we recommend using ``certbot-auto``, which
automates the process of installing Certbot on your system.
Beyond the methods discussed here, other methods may be possible, such as
installing Certbot directly with pip from PyPI or downloading a ZIP