touchify/nginx-certbot repository overview

⁠Supported tags and respective Dockerfile links

• 1.17.8, 1.17, 1, latest (Dockerfile)⁠

This image is updated via pull requests to the touchifyapp/docker-nginx-certbot GitHub repo⁠.

⁠Nginx⁠ & Certbot⁠: A container that include both nginx and certbot allowing to request and renew Let's Encrypt⁠ certificates automatically.

Nginx (pronounced "engine-x") is an open source reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer, HTTP cache, and a web server (origin server).

Certbot is a free, open source software tool for automatically using Let’s Encrypt⁠ certificates on manually-administrated websites to enable HTTPS.

⁠How to use

⁠Basic Usage

The following sample shows how to run the container to request a certificate for multiple domains.

docker run -dt \
  --name reverse-server \
  -p 80:80 \
  -p 443:443 \
  -v $(PWD)/letsencrypt:/etc/letsencrypt \
  -v $(PWD)/certbot:/usr/share/nginx/certbot \
  -e EMAIL="[email protected]" \
  -e DOMAINS="mycompany.com www.mycompany.com" \
  touchify/nginx-certbot

⁠Configuration

• EMAIL: Sets the email to use to request Let's Encrypt certificates.
• DOMAINS: Sets the domain(s) to request from Let's Encrypt. For multiple domains, separated by spaces.
• STAGING: Sets to 1 to use certbot in staging mode.

⁠License

View license information⁠ for the software contained in this image.

⁠Supported Docker versions

This image is officially supported on Docker version 1.12+.

Please see the Docker installation documentation⁠ for details on how to upgrade your Docker daemon.

⁠User Feedback

⁠Documentation

Documentation for this image is stored in the touchifyapp/docker-nginx-certbot GitHub repo⁠. Be sure to familiarize yourself with the repository's README.md file before attempting a pull request.

⁠Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue⁠.

⁠Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue⁠, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.