jflattery / lego

Let's Encrypt client and ACME library written in Go

lego

Let's Encrypt client and ACME library written in Go.

Features

• Register with CA
• Obtain certificates, both from scratch or with an existing CSR
• Renew certificates
• Revoke certificates
• Robust implementation of all ACME challenges
  • HTTP (http-01)
  • DNS (dns-01)
  • TLS (tls-alpn-01)
• SAN certificate support
• Comes with multiple optional DNS providers
• Custom challenge solvers
• Certificate bundling
• OCSP helper function

lego introduced support for ACME v2 in v1.0.0. If you still need to utilize ACME v1, you can do so by using the v0.5.0 version.

Installation

How to install.

Usage

• as a CLI
• as a library

Documentation

Documentation is hosted live at https://go-acme.github.io/lego/.

DNS providers

Detailed documentation is available here.

Alibaba Cloud DNS	Amazon Lightsail	Amazon Route 53	Aurora DNS
Autodns	Azure	Bindman	Bluecat
Checkdomain	Cloudflare	ClouDNS	CloudXNS
ConoHa	Constellix	Designate DNSaaS for Openstack	Digital Ocean
DNS Made Easy	DNSimple	DNSPod	Domain Offensive (do.de)
DreamHost	Duck DNS	Dyn	Dynu
EasyDNS	Exoscale	External program	FastDNS
Gandi Live DNS (v5)	Gandi	Glesys	Go Daddy
Google Cloud	Hosting.de	HTTP request	Internet Initiative Japan
INWX	Joker	Joohoi's ACME-DNS	Linode (deprecated)
Linode (v4)	Liquid Web	Manual	MyDNS.jp
Name.com	Namecheap	Namesilo	Netcup
NIFCloud	NS1	Open Telekom Cloud	Oracle Cloud
OVH	PowerDNS	Rackspace	reg.ru
RFC2136	RimuHosting	Sakura Cloud	Scaleway
Selectel	Servercow	Stackpath	TransIP
VegaDNS	Versio.[nl/eu/uk]	Vscale	Vultr
Zone.ee	Zonomi