Let's Encrypt WWW

For developer or website admin who need to manage certificate, the Letsencrypt-WWW is a command line tool that purely implemented by shell language, unlike other powerful and complex tool, LeWWW provide lightweight solution, you can easily adjust the source code and fit your requirement, powered by TDD and Let's Encrypt.

---

Table of Contents

• Operating System Tested
• Install
  • Prerequisites
  • Installing
• Running The Tests
• Usage
  • Shell
    • Demo
  • Docker
    • Demo
• Features
• Build With
• Contributing
• License

Operating System Tested

macOS Sierra	Ubuntu trusty	CentOS 7
Yes	Yes	Yes

Install

Prerequisites

With Shell

• OpenSSL

With Docker

• Docker compose 3

Installing

For customize or development:

git clone git@github.com:sunwei/letsencrypt-www.git
cd ./letsencrypt-www

./www --help

For tool used locally or in CI/CD. Check releases here: GitHub letsencrypt-www releases

cd /usr/local/bin
curl -OL  https://github.com/sunwei/letsencrypt-www/archive/v1.0.0.tar.gz
tar -xvzf v1.0.0.tar.gz
mv letsencrypt-www-1.0.0 letsencrypt-www
cd ./letsencrypt-www

./www --help

Running the tests

make tests

Usage

Take DNSPod provider for example, and issue your domain in all easy way:

1. Add your domain to DNSPod, you could do it here
2. Rename the environment parameters template to dnspod.env, and replace the id and token as yours. How to apply id and token

cd ./letsencrypt-www
cd ./secrets
mv dnspod.env.example dnspod.env

Shell

3. Issue your domain, default env is staging

./www --help
./www -p example.letsencryptwww.com

Demo

YouTube

[Youku] Coming soon...

Docker:

3. Config you docker env variable at ./configs/www.env
4. Build docker image and issue the domain

make build
make issue

Demo

Coming soon...

Features

• Challenge types

  • DNS-01 Supported
  • HTTP-01 coming soon...
  • TLS-SNI-01 coming...

• Providers

  • DNSPod Supported
  • Google coming soon
  • Others...

Build With

• Let's Encrypt as CA
• git-crypt to encrypt sensitive data
• Bats as test framework

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

For detail information, please refer to authors page

License

This project is licensed under the MIT License - see the LICENSE file for details