Skip to main content

Let's Encrypt client

Project description

Disclaimer

This is a DEVELOPER PREVIEW intended for developers and testers only.

DO NOT RUN THIS CODE ON A PRODUCTION SERVER. IT WILL INSTALL CERTIFICATES SIGNED BY A TEST CA, AND WILL CAUSE CERT WARNINGS FOR USERS.

Browser-trusted certificates will be available in the coming months.

For more information regarding the status of the project, please see https://letsencrypt.org. Be sure to checkout the Frequently Asked Questions (FAQ).

About the Let’s Encrypt Client

Travis CI status Coverage status Documentation status Docker Repository on Quay.io

In short: getting and installing SSL/TLS certificates made easy (watch demo video).

The Let’s Encrypt Client is a tool to automatically receive and install X.509 certificates to enable TLS on servers. The client will interoperate with the Let’s Encrypt CA which will be issuing browser-trusted certificates for free.

It’s all automated:

  • The tool will prove domain control to the CA and submit a CSR (Certificate Signing Request).

  • If domain control has been proven, a certificate will get issued and the tool will automatically install it.

All you need to do to sign a single domain is:

user@www:~$ sudo letsencrypt -d www.example.org auth

For multiple domains (SAN) use:

user@www:~$ sudo letsencrypt -d www.example.org -d example.org auth

and if you have a compatible web server (Apache or Nginx), Let’s Encrypt can not only get a new certificate, but also deploy it and configure your server automatically!:

user@www:~$ sudo letsencrypt -d www.example.org run

Encrypt ALL the things!

Current Features

  • Supports multiple web servers:

    • apache/2.x (tested and working on Ubuntu Linux)

    • nginx/0.8.48+ (under development)

    • standalone (runs its own simple webserver to prove you control a domain)

  • The private key is generated locally on your system.

  • Can talk to the Let’s Encrypt (demo) CA or optionally to other ACME compliant services.

  • Can get domain-validated (DV) certificates.

  • Can revoke certificates.

  • Adjustable RSA key bit-length (2048 (default), 4096, …).

  • Can optionally install a http -> https redirect, so your site effectively runs https only (Apache only)

  • Fully automated.

  • Configuration changes are logged and can be reverted.

  • Text and ncurses UI.

  • Free and Open Source Software, made with Python.

Installation Instructions

Official documentation, including installation instructions, is available at https://letsencrypt.readthedocs.org.

Project details


Download files

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

Source Distribution

letsencrypt-0.0.0.dev20151030.tar.gz (151.2 kB view details)

Uploaded Source

Built Distribution

letsencrypt-0.0.0.dev20151030-py2-none-any.whl (163.2 kB view details)

Uploaded Python 2

File details

Details for the file letsencrypt-0.0.0.dev20151030.tar.gz.

File metadata

File hashes

Hashes for letsencrypt-0.0.0.dev20151030.tar.gz
Algorithm Hash digest
SHA256 e309056485b3b0238ad88a12209e928649f4a4c76228700163d34657a46e3ed9
MD5 eb4bd8c6eed5f80f22c9cfb8cf67bbd1
BLAKE2b-256 87490a8bce6adbe782fe4150c377658a15651f9155920a44ac24ac87eace36de

See more details on using hashes here.

File details

Details for the file letsencrypt-0.0.0.dev20151030-py2-none-any.whl.

File metadata

File hashes

Hashes for letsencrypt-0.0.0.dev20151030-py2-none-any.whl
Algorithm Hash digest
SHA256 373b21a064f8426e2e8a0b19d1981c8bed9e7024366dd0c602b952fbe0f711e5
MD5 3e5f929e5bdab9f205fbdd55fa815369
BLAKE2b-256 67a3aa3932fd93470689a0f5350f10c7e6d0ac5b0c6362b7f16308df07a264e9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page