upstream/certbot
1
0
Fork 0
mirror of https://github.com/certbot/certbot.git synced 2026-02-16 09:07:49 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
Certificats Let's Encrypt
789 commits 845 branches 153 tags 121 MiB
Python 94.5%
Shell 3.7%
Batchfile 0.8%
Makefile 0.7%
Augeas 0.2%
Find a file
James Kasten 8d1d9b0734 PEP8 support for acme, acme_test, apache_configurator
2014-11-25 00:15:47 -08:00
letsencrypt PEP8 support for acme, acme_test, apache_configurator 2014-11-25 00:15:47 -08:00
.gitignore Use tox for tests 2014-11-22 15:04:36 +01:00
EULA Changed EULA to Yes/No to Agree/Disagree 2014-11-19 17:01:30 -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 Clean MANIFEST.in 2014-11-22 15:05:44 +01:00
README.md apt-get install libaugeas0 2014-11-23 20:48:07 +01:00
requirements.txt python-augeas from PyPI 2014-11-23 15:29:11 +01:00
setup.cfg Add missing newline at end of file 2014-11-22 15:14:14 +01:00
setup.py python-augeas from PyPI 2014-11-23 15:29:11 +01:00
tox.ini python-augeas from PyPI 2014-11-23 15:29:11 +01:00

README.md

This is the Let's Encrypt Agent DEVELOPER PREVIEW repository.

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

This code is intended for testing, demonstration, and integration engineering with OSes and hosting platforms. Currently the code works with Linux and Apache, though we will be expanding it to other platforms.

Running the demo code on Ubuntu

sudo apt-get install python python-setuptools python-virtualenv \
  python-dev gcc swig dialog libaugeas0 libssl-dev
virtualenv --no-site-packages venv
./venv/bin/python setup.py install
sudo ./venv/bin/letsencrypt

Note, that letsencrypt does not yet handle Debian unstable's Apache2 conf layout.

Hacking

  1. Bootstrap: ./venv/bin/python setup.py dev

  2. Test code base: ./venv/bin/tox

Command line usage

sudo ./letsencrypt.py  (default authentication mode using pythondialog) options

--text (text mode)
--privkey= (specify privatekey file to use to generate the certificate)
--csr= (Use a specific CSR. If this is specified, privkey must also be specified
    with the correct private key for the CSR)
--server (list the ACME CA server address)
--revoke (revoke a certificate)
--view-checkpoints (Used to view available checkpoints and see what configuration
    changes have been made)
--rollback=X (Revert the configuration X number of checkpoints)
--redirect (Automatically redirect all HTTP traffic to HTTPS for the newly
    authenticated vhost)
--no-redirect (Skip the HTTPS redirect question, allowing both HTTP and HTTPS)
--agree-eula (Skip the end user agreement screen)

More Information

Further Setup, documentation and open projects are available in the [Wiki] (https://github.com/letsencrypt/lets-encrypt-preview/wiki)

Join us at our IRC channel @ freenode.net #letsencrypt

Client software development can be discussed on this [mailing list] (https://groups.google.com/a/letsencrypt.org/forum/#!forum/client-dev)

To subscribe without a Google account, send mail to [client-dev+subscribe@letsencrypt.org] (mailto:client-dev+subscribe@letsencrypt.org).