Certbot for Docker

This image packages the free and open-source Certbot client for automating Let's Encrypt certificate issuance and renewal. It is based on Alpine Linux and installs Certbot with pip.

Features

• Obtain certificates from Let's Encrypt.
• Renew certificates with configurable cron jobs.
• Run renewal pre-, post-, and deploy hooks.
• Install Certbot DNS plugins with pip at startup.
• Handle signals with Tini.
• Configure the image with environment variables.
• Obtain and renew multiple certificates from one INI file (since version 1.1.0).

Quick Start

Ensure that your domain points to a valid IP address, then run Certbot once:

docker run -it -p 80:80 -v $(pwd)/data/certbot:/etc/letsencrypt \
-e EMAIL=your@email.com \
-e DOMAINS=example.com,www.example.com \
-e RUN_ONCE=1 \
--name certbot nbraun1/certbot

See the usage guide for automatic renewal, alternate ports, Docker Compose, volumes, ports, and published image tags.

Documentation

• Usage
• Configuration reference
• Multiple certificates
• Development

License

This project is open source under the Apache 2.0 license.