An open API service indexing awesome lists of open source software.

https://github.com/whs/acme-docker

acmetool in Docker
https://github.com/whs/acme-docker

acmetool docker

Last synced: 3 months ago
JSON representation

acmetool in Docker

Awesome Lists containing this project

README

          

# acmetool on Docker

**Deprecation notice:** I'm moving to [certbot](https://hub.docker.com/r/certbot/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](https://github.com/hlandau/acme) 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](https://github.com/hlandau/acme/blob/master/_doc/SCHEMA.md).

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:

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

To issue certificates, use `docker exec`:

```sh
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)