/acme-docker

acmetool in Docker

Primary LanguageShell

acmetool on Docker

Deprecation notice: I'm moving to certbot as acmetool does not support ACME v2 (nor it would work with my DNS provider setup). This image is no longer maintained

This image runs acmetool with cronjob to automatically renew certificates.

Usage

You need to mount /certs into the container, and possibly your web server. It contains acmetool's state directory.

Your web server must be configured to serve /.well-known/acme-challenge/ from /certs/root/.well-known/acme-challenge/, as this is how acmetool will verify certificates.

Example usage:

sudo docker run -d --name acmetool \
	-v certs:/certs \
	willwill/acme-docker

To issue certificates, use docker exec:

sudo docker exec acmetool acmetool want www.example.com example.com

Options

Following environment variables are available:

  • KEY_TYPE: rsa/ecdsa (default to ecdsa)
  • RSA_KEY_SIZE: default to 4096
  • ECDSA_CURVE: nistp256/nistp384/nistp521 (default to nistp256)
  • ACME_EMAIL: registration email (default to nothing)
  • ACME_SERVER: acme endpoint (default to https://acme-v01.api.letsencrypt.org/directory)

(to specify environment variable, pass -e VARIABLE=value to docker run before the image name)