upstream/certbot
1
0
Fork 0
mirror of https://github.com/certbot/certbot.git synced 2026-06-13 18:50:20 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
Certificats Let's Encrypt
1154 commits 887 branches 156 tags 134 MiB
Python 94.5%
Shell 3.7%
Batchfile 0.8%
Makefile 0.7%
Augeas 0.2%
Find a file
Thomas Waldmann 0a14007db2 refactor docs, please check 
- README has only the most important infos that a new reader needs in his first minute
  of contact with the project (to decide whether it is interesting or not)
- CHANGES shall later be a curated change log (== important changes between releases)
- separate docs into intro, using, project
- intro docs = include README, CHANGES (avoid duplication)
2015-01-25 21:30:24 +01:00
docs refactor docs, please check 2015-01-25 21:30:24 +01:00
letsencrypt Fix locally disable pylint messages 2015-01-25 10:23:21 +00:00
.gitignore gitignore: .coverage is a file 2014-11-27 22:49:15 +01:00
.pylintrc pylint: ignore providedBy 2015-01-24 13:59:19 +00:00
.travis.yml refactor docs, please check 2015-01-25 21:30:24 +01:00
CHANGES.rst refactor docs, please check 2015-01-25 21:30:24 +01:00
EULA Random small changes 2014-12-01 03:05:06 -08:00
letsencrypt.py letsencrypt.py as setuptools console script 2014-11-19 13:29:02 +01:00
LICENSE.txt Remove Unneccesary How To 2014-11-18 13:08:09 -08:00
MANIFEST.in Fix MANIFEST.in recursive-include 2014-12-10 12:34:42 +01:00
README.rst refactor docs, please check 2015-01-25 21:30:24 +01:00
requirements.txt Add mock to setup 2014-12-08 00:33:27 -08:00
setup.cfg setup.py docs, Sphinx dep 2014-11-30 02:38:33 +01:00
setup.py Merge pull request #188 from kuba/bugs/152 2015-01-24 20:01:32 -08:00
tox.ini Bump cover-min-percentage to 61 2015-01-24 14:33:19 +00:00

README.rst 

About the Let's Encrypt Client
==============================

In short: getting and installing SSL/TLS certificates made easy.

The Let's Encrypt Client is a tool that talks to the Let's Encrypt CA
so you can comfortably and quickly get trusted TLS certificates that just
work without warnings in every browser.

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 is:

::

   user@www:~$ sudo letsencrypt www.example.org


**Encrypt ALL the things!**


.. image:: https://travis-ci.org/letsencrypt/lets-encrypt-preview.svg?branch=master
    :target: https://travis-ci.org/letsencrypt/lets-encrypt-preview


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.**


Features
========

* web servers supported:

  - apache2.x (tested and working on Ubuntu Linux)

* 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 bitlength (2048 (default), 4096, ...)
* optionally can install a http->https redirect, so your site effectively
  runs https only
* fully automated
* configuration changes can be rolled back N checkpoints
* text and ncurses UI
* Free and Open Source Software, made with Python.


Links
-----

Documentation: https://letsencrypt.readthedocs.org/

Software project: https://github.com/letsencrypt/lets-encrypt-preview

Main Website: https://letsencrypt.org/

IRC Channel: #letsencrypt on `Freenode`_

Mailing list: `client-dev`_ (to subscribe without a Google account, send an
              email to client-dev+subscribe@letsencrypt.org)

.. _Freenode: https://freenode.net
.. _client-dev: https://groups.google.com/a/letsencrypt.org/forum/#!forum/client-dev