Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (testpypi.python.org).
Help us improve Python packaging - Donate today!

A Simple Let's Encrypt client

Project Description
# simp_le

[![Build Status](https://travis-ci.org/kuba/simp_le.svg?branch=master)](https://travis-ci.org/kuba/simp_le)

Simple [Let's Encrypt](https://letsencrypt.org) client.

```shell
simp_le -f fullchain.pem -f key.pem \
-d example.com -d www.example.com --default_root /var/www/html \
-d other.com:/var/www/other_html
```

For more info see `simp_le --help`.

## Manifest

1. [UNIX philosophy](https://en.wikipedia.org/wiki/Unix_philosophy):
Do one thing and do it well!

2. `simp_le --valid_min ${seconds?} -f cert.pem` implies that
`cert.pem` is valid for at at least `valid_min`. Register new ACME
CA account if necessary. Issue new certificate if no previous
key/certificate/chain found. Renew only if necessary.

3. (Sophisticated) "manager" for
`${webroot?}/.well-known/acme-challenge` only. No challenges other
than `http-01`. Existing web-server must be running already.

4. No magical webserver auto-configuration.

5. Owner of `${webroot?}/.well-known/acme-challenge` must be able to
run the script, without privilege escalation (`sudo`, `root`,
etc.).

6. `crontab` friendly: fully automatable - no prompts, etc.

7. No configuration files. CLI flags as the sole interface! Users
should write their own wrapper scripts or use shell aliases if
necessary.

8. Support multiple domains with multiple roots. Always create single
SAN certificate per `simp_le` run.

9. Flexible storage capabilities. Built-in `simp_le -f fullchain.pem
-f key.pem`, `simp_le -f chain.pem -f cert.pem -f key.pem`,
etc. Extensions through `simp_le -f external_pem.sh`.

10. Do not allow specifying output file paths. Users should symlink if
necessary!

11. No need to allow specifying an arbitrary command when renewal has
happened, just check the exit code:
- `0` if certificate data was created or updated;
- `1` if renewal not necessary;
- `2` in case of errors.

12. `--server` (support multiple CAs).

13. Support for revocation.

## Installation

```shell
sudo ./bootstrap.sh
./venv.sh
. venv/bin/activate
```

## Help

Have a look into `./examples/` and
https://github.com/kuba/simp_le/wiki/Examples.

If you're having problems you can chat with us on [IRC (#simp_le at
Freenode)](http://webchat.freenode.net?randomnick=1&channels=%23simp_le&prompt=1)

Release History

Release History

This version
History Node

0.0.1

History Node

0.0.1a2

History Node

0.0.1a1

History Node

0.0.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
simp_le-0.0.1.tar.gz (23.2 kB) Copy SHA256 Checksum SHA256 Source Dec 4, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting