lego/README.md
2026-03-08 23:32:56 +01:00

18 KiB
Raw Blame History

lego logo

Automatic Certificates and HTTPS for everyone.

Lego

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

Go Reference Build Status Docker Pulls

lego is an independent, free, and open-source project, if you value it, consider supporting it! ❤️

Everybody thinks that the others will donate, but in the end, nobody does.

So if you think that lego is worth it, please consider donating.

Features

  • ACME v2 RFC 8555
  • Comes with about 180 DNS providers
  • Register with CA
  • Obtain certificates, both from scratch or with an existing CSR
  • Renew certificates
  • Revoke certificates
  • Robust implementation of ACME challenges:
    • HTTP (http-01)
    • DNS (dns-01)
    • TLS (tls-alpn-01)
  • SAN certificate support
  • CNAME support by default
  • Custom challenge solvers
  • Certificate bundling
  • OCSP helper function

Installation

How to install.

Usage

Documentation

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

DNS providers

Detailed documentation is available here.

If your DNS provider is not supported, please open an issue.

35.com/三五互联 Active24 Akamai EdgeDNS Alibaba Cloud DNS
AlibabaCloud ESA all-inkl Alwaysdata Amazon Lightsail
Amazon Route 53 Anexia CloudDNS ArtFiles ArvanCloud
Aurora DNS Autodns Axelname Azion
Azure (deprecated) Azure DNS Baidu Cloud Beget.com
Binary Lane Bindman Bluecat Bluecat v2
BookMyName Brandit (deprecated) Bunny Checkdomain
Civo Cloud.ru CloudDNS Cloudflare
ClouDNS CloudXNS (Deprecated) ConoHa v2 ConoHa v3
Constellix Core-Networks CPanel/WHM Czechia
DDnss (DynDNS Service) Derak Cloud deSEC.io Designate DNSaaS for Openstack
Digital Ocean DirectAdmin DNS Made Easy DNSExit
dnsHome.de DNSimple DNSPod (deprecated) Domain Offensive (do.de)
Domeneshop DreamHost Duck DNS Dyn
DynDnsFree.de Dynu EasyDNS EdgeCenter
Efficient IP Epik EuroDNS Exoscale
External program F5 XC freemyip.com FusionLayer NameSurfer
G-Core Gandi Gandi Live DNS (v5) Gigahost.no
Glesys Go Daddy Google Cloud Google Domains
Gravity Hetzner Hosting.de Hosting.nl
Hostinger Hosttech HTTP request http.net
Huawei Cloud Hurricane Electric DNS HyperOne IBM Cloud (SoftLayer)
IIJ DNS Platform Service Infoblox Infomaniak Internet Initiative Japan
Internet.bs INWX Ionos Ionos Cloud
IPv64 ISPConfig 3 ISPConfig 3 - Dynamic DNS (DDNS) Module iwantmyname (Deprecated)
JD Cloud Joker Joohoi's ACME-DNS KeyHelp
Leaseweb Liara Lima-City Linode (v4)
Liquid Web Loopia LuaDNS Mail-in-a-Box
ManageEngine CloudDNS Manual Metaname Metaregistrar
mijn.host Mittwald myaddr.{tools,dev,io} MyDNS.jp
MythicBeasts Name.com Namecheap Namesilo
NearlyFreeSpeech.NET Neodigit Netcup Netlify
Nicmanager NIFCloud Njalla Nodion
NS1 Octenium Open Telekom Cloud Oracle Cloud
OVH plesk.com Porkbun PowerDNS
Rackspace Rain Yun/雨云 RcodeZero reg.ru
Regfish RFC2136 RimuHosting RU CENTER
Sakura Cloud Scaleway Selectel Selectel v2
SelfHost.(de|eu) Servercow Shellrent Simply.com
Sonic Spaceship Stackpath Syse
Technitium Tencent Cloud DNS Tencent EdgeOne Timeweb Cloud
TodayNIC/时代互联 TransIP UKFast SafeDNS Ultradns
United-Domains Variomedia VegaDNS Vercel
Versio.[nl|eu|uk] VinylDNS Virtualname VK Cloud
Volcano Engine/火山引擎 Vscale Vultr webnames.ca
webnames.ru Websupport WEDOS West.cn/西部数码
Yandex 360 Yandex Cloud Yandex PDD Zone.ee
ZoneEdit Zonomi

If your DNS provider is not supported, please open an issue.