Create and renew website certificates using the Letsencrypt free certificate authority.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 52 commits ahead of henridwyer:master.
staticfloat Merge pull request #6 from BrunoZell/master
Fix problems with rate limit - updated
Latest commit af4a499 Oct 3, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
example added baisc usage example Sep 20, 2018
src use domains private key file as timestamp Oct 3, 2018
LICENSE Just mess it all up Jan 2, 2017 Add usage example to `` May 2, 2018


Create and automatically renew website SSL certificates using the letsencrypt free certificate authority, and its client certbot, built on top of the nginx server.

More information

Find out more about letsencrypt:

Certbot github:

This repository was originally forked from @henridwyer, many thanks to him for the good idea. I've rewritten about 90% of this repository, so it bears almost no resemblance to the original. This repository is much more opinionated about the structure of your webservers/containers, however it is easier to use as long as all of your webservers follow that pattern.


Use this image with a Dockerfile such as:

FROM staticfloat/nginx-certbot
COPY *.conf /etc/nginx/conf.d/

And a .conf file such as:

server {
    listen              443 ssl;
    ssl_certificate     /etc/letsencrypt/live/;
    ssl_certificate_key /etc/letsencrypt/live/;

    location / {

Wrap this all up with a docker-compose.yml file:

version: '3'
        restart: unless-stopped
        build: frontend
            - 80:80/tcp
            - 443:443/tcp



  • Ditch cron, it never liked me anway. Just use sleep and a while loop instead.


  • Complete rewrite, build this image on top of the nginx image, and run cron/certbot alongside nginx so that we can have nginx configs dynamically enabled as we get SSL certificates.


  • Add script to /etc/letsencrypt/ so that users can bring nginx up before SSL certs are actually available.


  • Change the name to docker-certbot-cron, update documentation, strip out even more stuff I don't care about.


  • Rip out a bunch of stuff because @staticfloat is a monster, and likes to do things his way


  • Add support for webroot mode.
  • Run certbot once with all domains.


  • Upgraded to use certbot client
  • Changed image to use alpine linux


  • Initial release