Skip to content

Latest commit

 

History

History
32 lines (27 loc) · 1.41 KB

README.md

File metadata and controls

32 lines (27 loc) · 1.41 KB

ACME Issue & Renew

ACME Issue & Renew (acme) is a service container to issue and renew Let's Encrypt TLS certificates using @PhrozenByte's acme management scripts and acme-tiny.

This container is basically just an Alpine-based installation of these scripts. All certs and their associated files are stored in /var/local/acme, the configuration is stored in /etc/acme. Both directories are expected to be volumes. Please refer to the script's README.md for information about these directories and the required config. The container's entrypoint will create the necessary files and directories, so if there's no config.env, it will create it. You can use the script's env variables ACME_ACCOUNT_KEY_FILE, ACME_ACCOUNT_CONTACT, ACME_DIRECTORY_URL and TLS_KEY_GROUP to change the config on-the-fly.

The container runs crond by default. The only cronjob runs once a month (on the first day of the month at 00:00:00 UTC) and executes acme-renew --all. To issue new certs or to renew existing certs manually, call acme-issue or acme-renew inside the container, e.g.

podman exec -it acme acme-issue --force example.com www.example.com
podman exec -it acme acme-renew example.com