diff --git a/docs/using.rst b/docs/using.rst index 78967b90c..6370de963 100644 --- a/docs/using.rst +++ b/docs/using.rst @@ -378,20 +378,49 @@ Packages for Debian Jessie are coming in the next few weeks. **Gentoo** +The official Let's Encrypt client is available in Gentoo Portage. If you +want to use the Apache plugin, it has to be installed separately: + .. code-block:: shell emerge -av app-crypt/letsencrypt + emerge -av app-crypt/letsencrypt-apache -Currently, the Apache and nginx plugins are not included in Portage. You can -however use Layman to add the mrueg overlay which does include the plugin -packages: +Currently, only the Apache plugin is included in Portage. However, if you +want the nginx plugin, you can use Layman to add the mrueg overlay which +does include the nginx plugin package: .. code-block:: shell emerge -av app-portage/layman layman -S layman -a mrueg - emerge -av app-crypt/letsencrypt-apache app-crypt/letsencrypt-nginx + emerge -av app-crypt/letsencrypt-nginx + +When using the Apache plugin, you will run into a "cannot find a cert or key +directive" error if you're sporting the default Gentoo ``httpd.conf``. +You can fix this by commenting out two lines in ``/etc/apache2/httpd.conf`` +as follows: + +Change + +.. code-block:: shell + + + LoadModule ssl_module modules/mod_ssl.so + + +to + +.. code-block:: shell + + # + LoadModule ssl_module modules/mod_ssl.so + # + +For the time being, this is the only way for the Apache plugin to recognise +the appropriate directives when installing the certificate. +Note: this change is not required for the other plugins. **Other Operating Systems**