README.md

Integration examples

This repo provides examples for how to issue HTTPS certificates for getlocalcert subdomain names using various ACME clients.

You can use the example code as a quick start for your own projects. For more details, please see the documentation site.

Examples

Caddy

Sample code

LEGO

Sample code

Sample code

Traefik

Sample code

cert-manager

Sample code

acme.sh

Sample code

Sample code

Testing

A daily workflow runs to run the example code and issue a Let's Encrypt staging certificate. This helps detect incompatibility between the ACME clients and the getlocalcert service.

Running tests locally

The tests can be run locally using act.

./act -l
./act -s [email protected] -j register-and-issue

Sometimes we need to customize the container:

./act -s [email protected] -j lego-register-and-issue -P ubuntu-latest=golang:latest

A couple of the tests don't work with act. The Traefik example ends up being a tricky docker-in-docker example, which would be too ugly to support.