Using the Let's Encrypt client

Quick start

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, and issue the following command

sudo docker run -it --rm -p 443:443 --name letsencrypt \
            -v "/etc/letsencrypt:/etc/letsencrypt" \
            -v "/var/lib/letsencrypt:/var/lib/letsencrypt" \
            quay.io/letsencrypt/lets-encrypt-preview:latest

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

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

Note

If your operating system uses SWIG 3.0.5+, you will need to run pip install -r requirements-swig-3.0.5.txt -r requirements.txt instead of the standard pip install -r requirements.txt.
augeas is required for the python-augeas bindings

Ubuntu

sudo ./bootstrap/ubuntu.sh

Debian

sudo ./bootstrap/debian.sh

For squeeze you will need to:

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

Mac OSX

sudo ./bootstrap/mac.sh

Installation

virtualenv --no-site-packages -p python2 venv
./venv/bin/pip install -r requirements.txt

Usage

The letsencrypt commandline tool has a builtin help:

./venv/bin/letsencrypt --help

2.1 KiB Raw Blame History