Back to

Package challenge

Latest Go to latest

The latest major version is v4.

Published: Sep 1, 2020 | License: MIT | Module:



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

GoDoc Build Status Docker Pulls


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


How to install.



Documentation is hosted live at

DNS providers

Detailed documentation is available here.

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