No description
Find a file
2026-03-10 22:41:08 +01:00
.github chore: improve issue template 2026-03-04 17:59:58 +01:00
acme Detach v4.32.0 2026-02-19 13:14:28 +01:00
certcrypto fix: use IPs to define the main domain (#2817) 2026-01-28 18:41:23 +01:00
certificate fix: implement parsing for Retry-After header according to RFC 7231 (#2830) 2026-01-30 20:36:46 +01:00
challenge feat: allow to Unwrap obtainError (#2874) 2026-02-25 23:12:43 +01:00
cmd chore: generate 2026-03-10 19:36:34 +01:00
docs chore: generate 2026-03-10 19:36:34 +01:00
e2e chore: update pebble to v2.9.0 (#2763) 2025-12-19 02:27:38 +01:00
internal chore: move provider "manual" into a dedicated package (#2739) 2025-12-01 20:51:43 +01:00
lego tests: change the signature of the method BuildHTTPS (#2611) 2025-08-04 10:21:14 +00:00
log chore: update to go1.24 (#2566) 2025-07-08 17:23:52 +02:00
platform chore: update linter (#2699) 2025-10-30 13:02:35 +01:00
providers review: tests on errors 2026-03-10 22:41:08 +01:00
registration chore: update linter (#2699) 2025-10-30 13:02:35 +01:00
.dockerignore Automatic generation of documentation (#818) 2019-03-08 19:47:06 +01:00
.gitattributes chore: remove existing files before generating new files (#2676) 2025-10-18 16:46:55 +02:00
.gitcookies.enc Add workaround for go.googlesource.com rate limit 2016-03-22 01:46:32 +01:00
.gitignore Refactor the core of the lib (#700) 2018-12-06 22:50:17 +01:00
.golangci.yml chore: update linter, and workflows 2026-02-12 17:32:23 +01:00
.goreleaser.yml chore: add major version tag for Docker images (#2709) 2025-11-08 13:38:05 +01:00
buildx.Dockerfile chore: update release workflow (#2657) 2025-09-29 18:06:38 +02:00
CHANGELOG.md Prepare release v4.32.0 2026-02-19 13:14:13 +01:00
CONTRIBUTING.md docs: improve contributing guide 2025-12-15 23:34:25 +01:00
Dockerfile chore: use buildx for cross-platform image builds 2023-02-26 14:27:16 +01:00
go.mod chore: update dependencies (#2860) 2026-02-18 23:26:31 +01:00
go.sum chore: update dependencies (#2860) 2026-02-18 23:26:31 +01:00
LICENSE chore: update license date 2024-10-10 22:11:07 +02:00
Makefile chore: update documentation theme (#2632) 2025-08-28 23:44:26 +02:00
README.md chore: generate 2026-03-10 19:36:34 +01:00

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 ANS SafeDNS 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
Excedo 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
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.