certbot/docs/using.rst

Using the Let's Encrypt client

Prerequisites

The demo code is supported and known to work on Ubuntu and Debian. Therefore, prerequisites for other platforms listed below are provided mainly for the developers <hacking> reference.

In general:

• sudo is required as a suggested way of running privileged process
• swig is required for compiling m2crypto
• augeas is required for the python-augeas bindings

Ubuntu

sudo ./bootstrap/ubuntu.sh

Debian

sudo ./bootstrap/debian.sh

For squezze you will need to:

• Use virtualenv --no-site-packages -p python instead of -p python2.

Mac OSX

sudo ./bootstrap/mac.sh

Quick Usage

Using docker you can quickly get yourself a testing cert. From the server that the domain your requesting a cert for resolves to, download docker 1.5, and issue the following command:

docker run -it --rm -p 443:443 -v $PWD/certs/:/etc/letsencrypt/certs/ letsencrypt/lets-encrypt-preview

And follow the instructions. Your new cert will be available in certs/

Installation

virtualenv --no-site-packages -p python2 venv
./venv/bin/python setup.py install
sudo ./venv/bin/letsencrypt

Usage

The letsencrypt commandline tool has a builtin help:

./venv/bin/letsencrypt --help