Skip to content

Latest commit

 

History

History
59 lines (40 loc) · 2.21 KB

README.md

File metadata and controls

59 lines (40 loc) · 2.21 KB

docker-certbot

Installs cerbot into a Linux container

certbot

Description

Certbot is an easy-to-use automatic client that fetches and deploys SSL/TLS certificates for your webserver. Certbot was developed by EFF and others as a client for Lets Encrypt and was previously known as the official Lets Encrypt client or the Let's Encrypt Python client. Certbot will also work with any other CAs that support the ACME protocol.

https://certbot.eff.org/

Usage

Generating certificate

docker run --name=certbot \
  -v /etc/localtime:/etc/localtime:ro \
  -v <path to certificates>:/etc/letsencrypt \
  -e DOCKMAIL=<mail address> \
  -e DOCKMAILDOMAINS=<domains list> \
  -e DOCKUPGRADE=<0|1> \
  -p 80:80 \
  -p 443:443 \
  digrouz/cerbot certbot

Renewing certificate

docker run --name=certbot \
  -v /etc/localtime:/etc/localtime:ro \
  -v <path to certificates>:/etc/letsencrypt \
  -e DOCKMAIL=<mail address> \
  -e DOCKMAILDOMAINS=<domains list> \
  -e DOCKUPGRADE=<0|1> \
  -p 80:80 \
  -p 443:443 \
  digrouz/certbot certbot-renew

Environment Variables

When you start the certbot image, you can adjust the configuration of the certbot instance by passing one or more environment variables on the docker run command line.

DOCKUPGRADE

This variable is not mandatory and specifies if the container has to launch software update at startup or not. Valid values are 0 and 1. It has default value 0.

DOCKMAIL

This variable is mandatory and specifies the mail that has to be used to generate the certificates.

DOCKMAILDOMAINS

This variable is mandatory and specifies a list of domains (comma separated) for which a certificate should be generates

Notes

  • The docker entrypoint can upgrade operating system at each startup. To enable this feature, just add -e DOCKUPGRADE=1 at container creation.
  • This container uses the standalone authenticator methode which may require to stop any webserver or container that expose port 80 and/or 443.

Issues

If you encounter an issue please open a ticket at github