lego

module

v3.8.1 Latest Latest Go to latest Published: Jun 6, 2020 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/controlplanecom/lego

README ¶

lego

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

Features

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.

Installation

How to install.

Usage

as a CLI
as a library

Documentation

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

DNS providers

Detailed documentation is available here.


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

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
acme Package acme contains all objects related the ACME endpoints.	Package acme contains all objects related the ACME endpoints.
api
api/internal/nonces
api/internal/secure
api/internal/sender
certcrypto
certificate
challenge
dns01
http01
resolver
tlsalpn01
cmd
lego Let's Encrypt client to go! CLI application for generating Let's Encrypt certificates using the ACME package.	Let's Encrypt client to go! CLI application for generating Let's Encrypt certificates using the ACME package.
e2e
loader
internal
dnsdocs
lego
log
platform
config/env
tester
wait
providers
dns
dns/acmedns Package acmedns implements a DNS provider for solving DNS-01 challenges using Joohoi's acme-dns project.	Package acmedns implements a DNS provider for solving DNS-01 challenges using Joohoi's acme-dns project.
dns/alidns Package alidns implements a DNS provider for solving the DNS-01 challenge using Alibaba Cloud DNS.	Package alidns implements a DNS provider for solving the DNS-01 challenge using Alibaba Cloud DNS.
dns/arvancloud Package arvancloud implements a DNS provider for solving the DNS-01 challenge using ArvanCloud DNS.	Package arvancloud implements a DNS provider for solving the DNS-01 challenge using ArvanCloud DNS.
dns/arvancloud/internal
dns/auroradns Package auroradns implements a DNS provider for solving the DNS-01 challenge using Aurora DNS.	Package auroradns implements a DNS provider for solving the DNS-01 challenge using Aurora DNS.
dns/autodns Package autodns implements a DNS provider for solving the DNS-01 challenge using auto DNS.	Package autodns implements a DNS provider for solving the DNS-01 challenge using auto DNS.
dns/azure Package azure implements a DNS provider for solving the DNS-01 challenge using azure DNS.	Package azure implements a DNS provider for solving the DNS-01 challenge using azure DNS.
dns/bindman Package bindman implements a DNS provider for solving the DNS-01 challenge.	Package bindman implements a DNS provider for solving the DNS-01 challenge.
dns/bluecat Package bluecat implements a DNS provider for solving the DNS-01 challenge using a self-hosted Bluecat Address Manager.	Package bluecat implements a DNS provider for solving the DNS-01 challenge using a self-hosted Bluecat Address Manager.
dns/checkdomain Package checkdomain implements a DNS provider for solving the DNS-01 challenge using CheckDomain DNS.	Package checkdomain implements a DNS provider for solving the DNS-01 challenge using CheckDomain DNS.
dns/clouddns Package clouddns implements a DNS provider for solving the DNS-01 challenge using CloudDNS API.	Package clouddns implements a DNS provider for solving the DNS-01 challenge using CloudDNS API.
dns/clouddns/internal
dns/cloudflare Package cloudflare implements a DNS provider for solving the DNS-01 challenge using cloudflare DNS.	Package cloudflare implements a DNS provider for solving the DNS-01 challenge using cloudflare DNS.
dns/cloudns Package cloudns implements a DNS provider for solving the DNS-01 challenge using ClouDNS DNS.	Package cloudns implements a DNS provider for solving the DNS-01 challenge using ClouDNS DNS.
dns/cloudns/internal
dns/cloudxns Package cloudxns implements a DNS provider for solving the DNS-01 challenge using CloudXNS DNS.	Package cloudxns implements a DNS provider for solving the DNS-01 challenge using CloudXNS DNS.
dns/cloudxns/internal
dns/conoha Package conoha implements a DNS provider for solving the DNS-01 challenge using ConoHa DNS.	Package conoha implements a DNS provider for solving the DNS-01 challenge using ConoHa DNS.
dns/conoha/internal
dns/constellix Package constellix implements a DNS provider for solving the DNS-01 challenge using Constellix DNS.	Package constellix implements a DNS provider for solving the DNS-01 challenge using Constellix DNS.
dns/constellix/internal
dns/desec Package desec implements a DNS provider for solving the DNS-01 challenge using deSEC DNS.	Package desec implements a DNS provider for solving the DNS-01 challenge using deSEC DNS.
dns/desec/internal
dns/designate Package designate implements a DNS provider for solving the DNS-01 challenge using the Designate DNSaaS for Openstack.	Package designate implements a DNS provider for solving the DNS-01 challenge using the Designate DNSaaS for Openstack.
dns/digitalocean Package digitalocean implements a DNS provider for solving the DNS-01 challenge using digitalocean DNS.	Package digitalocean implements a DNS provider for solving the DNS-01 challenge using digitalocean DNS.
dns/dnsimple Package dnsimple implements a DNS provider for solving the DNS-01 challenge using dnsimple DNS.	Package dnsimple implements a DNS provider for solving the DNS-01 challenge using dnsimple DNS.
dns/dnsmadeeasy Package dnsmadeeasy implements a DNS provider for solving the DNS-01 challenge using DNS Made Easy.	Package dnsmadeeasy implements a DNS provider for solving the DNS-01 challenge using DNS Made Easy.
dns/dnsmadeeasy/internal
dns/dnspod Package dnspod implements a DNS provider for solving the DNS-01 challenge using dnspod DNS.	Package dnspod implements a DNS provider for solving the DNS-01 challenge using dnspod DNS.
dns/dode Package dode implements a DNS provider for solving the DNS-01 challenge using do.de.	Package dode implements a DNS provider for solving the DNS-01 challenge using do.de.
dns/dreamhost Package dreamhost implements a DNS provider for solving the DNS-01 challenge using DreamHost.	Package dreamhost implements a DNS provider for solving the DNS-01 challenge using DreamHost.
dns/duckdns Package duckdns implements a DNS provider for solving the DNS-01 challenge using DuckDNS.	Package duckdns implements a DNS provider for solving the DNS-01 challenge using DuckDNS.
dns/dyn Package dyn implements a DNS provider for solving the DNS-01 challenge using Dyn Managed DNS.	Package dyn implements a DNS provider for solving the DNS-01 challenge using Dyn Managed DNS.
dns/dynu Package dynu implements a DNS provider for solving the DNS-01 challenge using Dynu DNS.	Package dynu implements a DNS provider for solving the DNS-01 challenge using Dynu DNS.
dns/dynu/internal
dns/easydns Package easydns implements a DNS provider for solving the DNS-01 challenge using EasyDNS API.	Package easydns implements a DNS provider for solving the DNS-01 challenge using EasyDNS API.
dns/exec Package exec implements a DNS provider which runs a program for adding/removing the DNS record.	Package exec implements a DNS provider which runs a program for adding/removing the DNS record.
dns/exoscale Package exoscale implements a DNS provider for solving the DNS-01 challenge using exoscale DNS.	Package exoscale implements a DNS provider for solving the DNS-01 challenge using exoscale DNS.
dns/fastdns Package fastdns implements a DNS provider for solving the DNS-01 challenge using FastDNS.	Package fastdns implements a DNS provider for solving the DNS-01 challenge using FastDNS.
dns/gandi Package gandi implements a DNS provider for solving the DNS-01 challenge using Gandi DNS.	Package gandi implements a DNS provider for solving the DNS-01 challenge using Gandi DNS.
dns/gandiv5 Package gandiv5 implements a DNS provider for solving the DNS-01 challenge using Gandi LiveDNS api.	Package gandiv5 implements a DNS provider for solving the DNS-01 challenge using Gandi LiveDNS api.
dns/gcloud Package gcloud implements a DNS provider for solving the DNS-01 challenge using Google Cloud DNS.	Package gcloud implements a DNS provider for solving the DNS-01 challenge using Google Cloud DNS.
dns/glesys Package glesys implements a DNS provider for solving the DNS-01 challenge using GleSYS api.	Package glesys implements a DNS provider for solving the DNS-01 challenge using GleSYS api.
dns/godaddy Package godaddy implements a DNS provider for solving the DNS-01 challenge using godaddy DNS.	Package godaddy implements a DNS provider for solving the DNS-01 challenge using godaddy DNS.
dns/hetzner Package hetzner implements a DNS provider for solving the DNS-01 challenge using Hetzner DNS.	Package hetzner implements a DNS provider for solving the DNS-01 challenge using Hetzner DNS.
dns/hetzner/internal
dns/hostingde Package hostingde implements a DNS provider for solving the DNS-01 challenge using hosting.de.	Package hostingde implements a DNS provider for solving the DNS-01 challenge using hosting.de.
dns/httpreq Package httpreq implements a DNS provider for solving the DNS-01 challenge through a HTTP server.	Package httpreq implements a DNS provider for solving the DNS-01 challenge through a HTTP server.
dns/iij Package iij implements a DNS provider for solving the DNS-01 challenge using IIJ DNS.	Package iij implements a DNS provider for solving the DNS-01 challenge using IIJ DNS.
dns/internal/rimuhosting
dns/internal/selectel
dns/inwx Package inwx implements a DNS provider for solving the DNS-01 challenge using inwx dom robot	Package inwx implements a DNS provider for solving the DNS-01 challenge using inwx dom robot
dns/joker Package joker implements a DNS provider for solving the DNS-01 challenge using joker.com DMAPI.	Package joker implements a DNS provider for solving the DNS-01 challenge using joker.com DMAPI.
dns/lightsail Package lightsail implements a DNS provider for solving the DNS-01 challenge using AWS Lightsail DNS.	Package lightsail implements a DNS provider for solving the DNS-01 challenge using AWS Lightsail DNS.
dns/linode Package linode implements a DNS provider for solving the DNS-01 challenge using Linode DNS.	Package linode implements a DNS provider for solving the DNS-01 challenge using Linode DNS.
dns/linodev4 Package linodev4 implements a DNS provider for solving the DNS-01 challenge using Linode DNS and Linode's APIv4	Package linodev4 implements a DNS provider for solving the DNS-01 challenge using Linode DNS and Linode's APIv4
dns/liquidweb Package liquidweb implements a DNS provider for solving the DNS-01 challenge using Liquid Web.	Package liquidweb implements a DNS provider for solving the DNS-01 challenge using Liquid Web.
dns/luadns Package luadns implements a DNS provider for solving the DNS-01 challenge using LuaDNS.	Package luadns implements a DNS provider for solving the DNS-01 challenge using LuaDNS.
dns/luadns/internal
dns/mydnsjp Package mydnsjp implements a DNS provider for solving the DNS-01 challenge using MyDNS.jp.	Package mydnsjp implements a DNS provider for solving the DNS-01 challenge using MyDNS.jp.
dns/mythicbeasts Package mythicbeasts implements a DNS provider for solving the DNS-01 challenge using Mythic Beasts API.	Package mythicbeasts implements a DNS provider for solving the DNS-01 challenge using Mythic Beasts API.
dns/namecheap Package namecheap implements a DNS provider for solving the DNS-01 challenge using namecheap DNS.	Package namecheap implements a DNS provider for solving the DNS-01 challenge using namecheap DNS.
dns/namedotcom Package namedotcom implements a DNS provider for solving the DNS-01 challenge using Name.com's DNS service.	Package namedotcom implements a DNS provider for solving the DNS-01 challenge using Name.com's DNS service.
dns/namesilo Package namesilo implements a DNS provider for solving the DNS-01 challenge using namesilo DNS.	Package namesilo implements a DNS provider for solving the DNS-01 challenge using namesilo DNS.
dns/netcup Package netcup implements a DNS Provider for solving the DNS-01 challenge using the netcup DNS API.	Package netcup implements a DNS Provider for solving the DNS-01 challenge using the netcup DNS API.
dns/netcup/internal
dns/netlify Package netlify implements a DNS provider for solving the DNS-01 challenge using Netlify.	Package netlify implements a DNS provider for solving the DNS-01 challenge using Netlify.
dns/netlify/internal
dns/nifcloud Package nifcloud implements a DNS provider for solving the DNS-01 challenge using NIFCLOUD DNS.	Package nifcloud implements a DNS provider for solving the DNS-01 challenge using NIFCLOUD DNS.
dns/nifcloud/internal
dns/ns1 Package ns1 implements a DNS provider for solving the DNS-01 challenge using NS1 DNS.	Package ns1 implements a DNS provider for solving the DNS-01 challenge using NS1 DNS.
dns/oraclecloud
dns/otc Package otc implements a DNS provider for solving the DNS-01 challenge using Open Telekom Cloud Managed DNS.	Package otc implements a DNS provider for solving the DNS-01 challenge using Open Telekom Cloud Managed DNS.
dns/ovh Package ovh implements a DNS provider for solving the DNS-01 challenge using OVH DNS.	Package ovh implements a DNS provider for solving the DNS-01 challenge using OVH DNS.
dns/pdns Package pdns implements a DNS provider for solving the DNS-01 challenge using PowerDNS nameserver.	Package pdns implements a DNS provider for solving the DNS-01 challenge using PowerDNS nameserver.
dns/rackspace Package rackspace implements a DNS provider for solving the DNS-01 challenge using rackspace DNS.	Package rackspace implements a DNS provider for solving the DNS-01 challenge using rackspace DNS.
dns/regru Package regru implements a DNS provider for solving the DNS-01 challenge using reg.ru DNS.	Package regru implements a DNS provider for solving the DNS-01 challenge using reg.ru DNS.
dns/regru/internal
dns/rfc2136 Package rfc2136 implements a DNS provider for solving the DNS-01 challenge using the rfc2136 dynamic update.	Package rfc2136 implements a DNS provider for solving the DNS-01 challenge using the rfc2136 dynamic update.
dns/rimuhosting Package rimuhosting implements a DNS provider for solving the DNS-01 challenge using RimuHosting DNS.	Package rimuhosting implements a DNS provider for solving the DNS-01 challenge using RimuHosting DNS.
dns/route53 Package route53 implements a DNS provider for solving the DNS-01 challenge using AWS Route 53 DNS.	Package route53 implements a DNS provider for solving the DNS-01 challenge using AWS Route 53 DNS.
dns/sakuracloud Package sakuracloud implements a DNS provider for solving the DNS-01 challenge using SakuraCloud DNS.	Package sakuracloud implements a DNS provider for solving the DNS-01 challenge using SakuraCloud DNS.
dns/scaleway Package scaleway implements a DNS provider for solving the DNS-01 challenge using Scaleway Domains API.	Package scaleway implements a DNS provider for solving the DNS-01 challenge using Scaleway Domains API.
dns/scaleway/internal
dns/selectel Package selectel implements a DNS provider for solving the DNS-01 challenge using Selectel Domains API.	Package selectel implements a DNS provider for solving the DNS-01 challenge using Selectel Domains API.
dns/servercow Package servercow implements a DNS provider for solving the DNS-01 challenge using Servercow DNS.	Package servercow implements a DNS provider for solving the DNS-01 challenge using Servercow DNS.
dns/servercow/internal
dns/stackpath Package stackpath implements a DNS provider for solving the DNS-01 challenge using Stackpath DNS.	Package stackpath implements a DNS provider for solving the DNS-01 challenge using Stackpath DNS.
dns/transip Package transip implements a DNS provider for solving the DNS-01 challenge using TransIP.	Package transip implements a DNS provider for solving the DNS-01 challenge using TransIP.
dns/vegadns Package vegadns implements a DNS provider for solving the DNS-01 challenge using VegaDNS.	Package vegadns implements a DNS provider for solving the DNS-01 challenge using VegaDNS.
dns/versio Package versio implements a DNS provider for solving the DNS-01 challenge using versio DNS.	Package versio implements a DNS provider for solving the DNS-01 challenge using versio DNS.
dns/vscale Package vscale implements a DNS provider for solving the DNS-01 challenge using Vscale Domains API.	Package vscale implements a DNS provider for solving the DNS-01 challenge using Vscale Domains API.
dns/vultr Package vultr implements a DNS provider for solving the DNS-01 challenge using the Vultr DNS.	Package vultr implements a DNS provider for solving the DNS-01 challenge using the Vultr DNS.
dns/yandex Package yandex implements a DNS provider for solving the DNS-01 challenge using Yandex.	Package yandex implements a DNS provider for solving the DNS-01 challenge using Yandex.
dns/yandex/internal
dns/zoneee Package zoneee implements a DNS provider for solving the DNS-01 challenge through zone.ee.	Package zoneee implements a DNS provider for solving the DNS-01 challenge through zone.ee.
dns/zonomi Package zonomi implements a DNS provider for solving the DNS-01 challenge using Zonomi DNS.	Package zonomi implements a DNS provider for solving the DNS-01 challenge using Zonomi DNS.
http/memcached Package memcached implements a HTTP provider for solving the HTTP-01 challenge using memcached in combination with a webserver.	Package memcached implements a HTTP provider for solving the HTTP-01 challenge using memcached in combination with a webserver.
http/webroot Package webroot implements a HTTP provider for solving the HTTP-01 challenge using web server's root path.	Package webroot implements a HTTP provider for solving the HTTP-01 challenge using web server's root path.
registration