No description
Find a file
Fernandez Ludovic 82ebca5726 chore: generate
2026-03-04 00:51:05 +01:00
.github chore: update linter (#2857) 2026-02-17 23:34:27 +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-04 00:51:05 +01:00
docs chore: generate 2026-03-04 00:51:05 +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 chore: generate 2026-03-04 00:51:05 +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-04 00:51:05 +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 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) Com Laude ConoHa v2
ConoHa v3 Constellix Core-Networks CPanel/WHM
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 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.