megazoll/certbot-vscale repository overview

⁠certbot-vscale

⁠What is this?

certbot-vscale is a Docker⁠ image based on the latest Certbot⁠ image for obtaining Let's Encrypt⁠ certificates if you use VScale⁠ DNS management.

⁠How does it work?

This image extends the original certbot/certbot image⁠ with two scripts:

• authenticator.py
• cleanup.py

It makes a request to the VScale API⁠ to create a TXT record for the DNS challenge. The record is cleaned up after verification.

⁠Example usage

Pass your API token (found in the control panel⁠) as an environment variable and mount your target volume to the container to store certificates.

Here, Docker's volume srv_letsencrypt-data is mounted, but you can use any other directory.

$ docker run \
  --rm \
  --name certbot \
  -e API_TOKEN=[...] \
  -v srv_letsencrypt-data:/etc/letsencrypt \
  egorovli/certbot-vscale certonly \
  --manual \
  --agree-tos \
  --manual-public-ip-logging-ok \
  --noninteractive \
  --email [email protected] \
  --preferred-challenges=dns \
  --manual-auth-hook ./scripts/authenticator.py \
  --manual-cleanup-hook ./scripts/cleanup.py \
  -d 'example.org' \
  -d '*.example.org'