letsencrypt /boulder

An ACME-based certificate authority, written in Go.

★ 5,790⑂ 650👁 131⑃ 5,694● 3,436▤ 250
GoMPL-2.0Created 2014-12-21
下载:v0.20261110.0v0.20261110.0 ↓0.20261110.02026-11-10
+1
日增长
5,790
stars
650
forks
131
watchers
5,694
prs
3,436
issues
250
releases

README

Boulder - An ACME CA



This is an implementation of an ACME-based CA. The ACME
protocol allows the CA to automatically
verify that an applicant for a certificate actually controls an identifier, and
allows subscribers to issue and revoke certificates for the identifiers they
control. Boulder is the software that runs Let's
Encrypt.

 Contents

 Overview
 Setting up Boulder
   Development
   Working with Certbot
   Working with another ACME Client
   Production
 Contributing
 License

 Overview

Boulder is divided into the following main components:

1. Web Front Ends (one per API version)
2. Registration Authority
3. Validation Authority
4. Certificate Authority
5. Storage Authority
6. Publisher
7. CRL Updater

This component model lets us separate the function of the CA by security
context. The Web Front End, Validation Authority, CRL Storer, and
Publisher need access to the Internet, which puts them at greater risk of
compromise. The Registration Authority can live without Internet
connectivity, but still needs to talk to the Web Front End and Validation
Authority. The Certificate Authority need only receive instructions from the
Registration Authority. All components talk to the SA for storage, so most
lines indicating SA RPCs are not shown here.

text
                            CA --------- Publisher
                             ^
                             |
       Subscriber - WFE -- RA -- SA -- MariaDB
                             |               ^
Subscriber server  S3 


Run integration tests (omit --filter  to run all):

shell
docker compose run --use-aliases boulder python3 test/integration-test.py --chisel --gotest --filter 


 Working with Certbot

Check out the Certbot client from https://github.com/certbot/certbot and
follow their setup instructions. Once you've got the client set up, you'll
probably want to run it against your local Boulder. There are a number of
command line flags that are necessary to run the client against a local
Boulder, and without root access. The simplest way to run the client locally
is to use a convenient alias for certbot (certbot_test) with a custom
SERVER environment variable:

shell
SERVER=http://localhost:4001/directory certbot_test certonly --standalone -d test.example.com


Your local Boulder instance uses a fake DNS resolver that returns 127.0.0.1
for any query, so you can use any value for the -d flag. To return an answer
other than 127.0.0.1 change the Boulder FAKE_DNS environment variable to
another IP address.

 Working with another ACME Client

Once you have followed the Boulder development environment instructions and have
started the containers you will find the ACME endpoints exposed to your host at
the following URLs:

 ACME v2, HTTP: http://localhost:4001/directory
 ACME v2, HTTPS: https://localhost:4431/directory

To access the HTTPS versions of the endpoints you will need to configure your
ACME client software to use a CA truststore that contains the
test/certs/ipki/minica.pem CA 

Top issues

Latest release

v0.20261110.0 v0.20261110.0 2026-11-10
What's Changed
 allow ML-DSA end-entity keys in MTCs by @jsha in https://github.com/letsencrypt/boulder/pull/9154
 Use structured logging for MTC components by @aarongable in https://github.com/letsencrypt/boulder/pull/9152
 Stop requiring RFC6962 logs by @mcpherrinm in https://github.com/letsencrypt/boulder/pull/9159
 Bump to Go 1.27.4 by @jsha in https://github.com/letsencrypt/boulder/pull/9171


Full Changelog: https://github.com/letsencrypt/boulder/compare/v0.20261105.0...v0.20261110.0

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON