No description
Find a file
2025-10-17 13:38:14 +02:00
.github chore: update release workflow (#2657) 2025-09-29 18:06:38 +02:00
acme Prepare release v4.27.0 2025-10-17 13:38:14 +02:00
certcrypto tests: use better test domains (#2603) 2025-07-28 09:26:40 +02:00
certificate tests: change the signature of the method BuildHTTPS (#2611) 2025-08-04 10:21:14 +00:00
challenge chore: update to github.com/cenkalti/backoff/v5 (#2668) 2025-10-15 13:42:00 +02:00
cmd Prepare release v4.27.0 2025-10-17 13:38:14 +02:00
docs hetzner: update to new API (#2663) 2025-10-14 21:56:06 +02:00
e2e tests: use better test domains (#2603) 2025-07-28 09:26:40 +02:00
internal chore: update to go1.24 (#2566) 2025-07-08 17:23:52 +02: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: replace wait.For with backoff inside DNS providers (#2671) 2025-10-15 18:26:51 +02:00
providers Prepare release v4.27.0 2025-10-17 13:38:14 +02:00
registration tests: change the signature of the method BuildHTTPS (#2611) 2025-08-04 10:21:14 +00:00
.dockerignore Automatic generation of documentation (#818) 2019-03-08 19:47:06 +01:00
.gitattributes docs: improve units and default values (#2397) 2025-01-11 15:35:31 +01: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 tests: new DNS router/server/mock (#2613) 2025-08-08 18:28:50 +02:00
.goreleaser.yml docs: sponsor incentives 2025-10-16 21:59:48 +02:00
buildx.Dockerfile chore: update release workflow (#2657) 2025-09-29 18:06:38 +02:00
CHANGELOG.md Prepare release v4.27.0 2025-10-17 13:38:14 +02:00
CONTRIBUTING.md chore: fix grammar and typo (#1978) 2023-07-29 12:59:24 +02:00
Dockerfile chore: use buildx for cross-platform image builds 2023-02-26 14:27:16 +01:00
go.mod chore: update dependencies (#2673) 2025-10-16 20:49:25 +02:00
go.sum chore: update dependencies (#2673) 2025-10-16 20:49:25 +02: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 docs: sponsor incentives 2025-10-16 21:59:48 +02:00

lego logo

Automatic Certificates and HTTPS for everyone.

Lego

Let's Encrypt client and ACME library 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 170 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.

Active24 Akamai EdgeDNS Alibaba Cloud DNS all-inkl
Amazon Lightsail Amazon Route 53 ArvanCloud Aurora DNS
Autodns Axelname Azion Azure (deprecated)
Azure DNS Baidu Cloud Beget.com Binary Lane
Bindman Bluecat BookMyName Brandit (deprecated)
Bunny Checkdomain Civo Cloud.ru
CloudDNS Cloudflare ClouDNS CloudXNS (Deprecated)
ConoHa v2 ConoHa v3 Constellix Core-Networks
CPanel/WHM Derak Cloud deSEC.io Designate DNSaaS for Openstack
Digital Ocean DirectAdmin DNS Made Easy dnsHome.de
DNSimple DNSPod (deprecated) Domain Offensive (do.de) Domeneshop
DreamHost Duck DNS Dyn DynDnsFree.de
Dynu EasyDNS Efficient IP Epik
Exoscale External program F5 XC freemyip.com
G-Core Gandi Gandi Live DNS (v5) Glesys
Go Daddy Google Cloud Google Domains Hetzner
Hosting.de 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
IPv64 iwantmyname Joker Joohoi's ACME-DNS
KeyHelp 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 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 Technitium Tencent Cloud DNS
Tencent EdgeOne Timeweb Cloud TransIP UKFast SafeDNS
Ultradns Variomedia VegaDNS Vercel
Versio.[nl|eu|uk] VinylDNS VK Cloud Volcano Engine/火山引擎
Vscale Vultr Webnames 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.