Repository files navigation

Sewer is a Let's Encrypt(ACME) client.
It's name is derived from Kenyan hip hop artiste, Kitu Sewer.

• The stable release is0.8.4.
• More history (including notes on 0.8.5-to-be) in theCHANGELOG.

PYTHON compatibility: 3.7 and above are tested.

I (maintainer @mmaney) loiter in channel ##sewer (on irc.freenode.net) forthose who remember IRC. Don't ask to ask, but waiting is.

• Obtain or renew SSL/TLS certificates fromLet's Encrypt
• Supports acme version 2 (current RFC including post-as-get).
• Support for SAN certificates.
• Supportswildcard certificates.
• Bundling certificates.
• Support for both RSA and ECDSA for account and certificate keys.
• SupportsDNS and HTTP challenges
  • List of currently supportedDNS services and BYO-service notes
  • HTTP challenges are a new feature, no operational drivers in the treeyet.See usage and BYO-service notes
• sewer is both acommand-line programand aPython library for custom use
• Well written(if I have to say so myself):
  • Good test coverage
  • Passing continuous integration
  • High grade statically analyzed code
  • type hinting to support mypy verification is a recently begun WIP

pip install sewer# with All DNS Provider support, include aliyun, Hurricane Electric, Aurora, ACME ...# pip3 install sewer[alldns]# with Cloudflare support# pip3 install sewer[cloudflare]# with Aliyun support# pip3 install sewer[aliyun]# with HE DNS(Hurricane Electric DNS) support# pip3 install sewer[hurricane]# with Aurora DNS Support# pip3 install sewer[aurora]# with ACME DNS Support# pip3 install sewer[acmedns]# with Rackspace DNS Support# pip3 install sewer[rackspace]# with DNSPod DNS Support# pip3 install sewer[dnspod]# with DuckDNS DNS Support# pip3 install sewer[duckdns]# with ClouDNS DNS Support# pip3 install sewer[cloudns]# with AWS Route 53 DNS Support# pip3 install sewer[route53]# with PowerDNS DNS Support# pip3 install sewer[powerdns]

sewer(since version 0.5.0) is now python3 only. To install the (nowunsupported) python2 version:

pip install sewer==0.3.0

Sewer is in active development and it's API will change in backward incompatible ways.https://pypi.python.org/pypi/sewer

See the how to contributedocumentation

• Why another ACME client?
  I wanted an ACME client that I could use to programmatically(as a library) acquire/get certificates. However I could notfind anything satisfactory for use in Python code.
• Why is it called Sewer?I really like the Kenyan hip hop artiste going by the name of Kitu Sewer.