serversideup/certbot-dns-cloudflare repository overview

⁠Certbot Cloudflare DNS Docker Container

SSL certificates that renew themselves. Built on the official Certbot image⁠ with an improved user experience, this image generates free Let's Encrypt certificates via Cloudflare DNS validation, renews them automatically, and saves them to a volume any container can read — so even applications without Let's Encrypt support get always-valid certificates. No config files, no exposed ports — just set a few environment variables and deploy.

Docker Image	Size
serversideup/certbot-dns-cloudflare⁠

⁠Base Image

The image is based on certbot/dns-cloudflare:latest, providing a stable and up-to-date environment for running Certbot with Cloudflare DNS authentication.

⁠Features

• Automatic SSL certificate generation and renewal using Let's Encrypt
• No configs needed, this image generates the cloudflare.ini file for you
• Cloudflare DNS authentication for domain validation
• Customizable configuration via environment variables
• Periodic certificate renewal checks
• Windows support (set REPLACE_SYMLINKS to true)
• Native Docker health checks to ensure the server is running

⁠Works great for orchestrated deployments

We designed this image to work great in orchestrated deployments like Kubernetes, Docker Swarm, or even in Github Actions. Look how simple the syntax is:

  certbot:
    image: serversideup/certbot-dns-cloudflare
    volumes:
      - certbot_data:/etc/letsencrypt
    environment:
      CLOUDFLARE_API_TOKEN: "${CLOUDFLARE_API_TOKEN}"
      CERTBOT_EMAIL: "${CERTBOT_EMAIL}"
      CERTBOT_DOMAINS: "${CERTBOT_DOMAINS}"
      CERTBOT_KEY_TYPE: "rsa"

  volumes:
    certbot_data:

⁠Environment Variables

The following environment variables can be used to customize the Certbot container:

⁠Creating a Cloudflare API Token

1. Go to the Cloudflare API Tokens⁠ page.
2. Click on "Create Token".
3. Click "Use template" for the "Edit Zone DNS" template.
4. Change the token name (optional)
5. Set a specific zone under "Zone Resources" (optional)
6. Click on "Continue to summary".
7. Click on "Create Token".

⁠Usage

1. Pull the Docker image:

   docker pull serversideup/certbot-dns-cloudflare:latest
   

   Copy

2. Run the container with the required environment variables:

docker run \
 -e CERTBOT_DOMAINS="yourdomain.com" \
 -e CERTBOT_EMAIL="[email protected]" \
 -e CLOUDFLARE_API_TOKEN="your-cloudflare-api-token" \
 -v /path/to/your/certs:/etc/letsencrypt \
serversideup/certbot-dns-cloudflare:latest

1. The container will automatically generate and renew the certificate.

⁠Resources

• Discord⁠ for friendly support from the community and the team.
• GitHub⁠ for source code, bug reports, and project management.
• Get Professional Help⁠ - Get video + screen-sharing help directly from the core contributors.

⁠Contributing

As an open-source project, we strive for transparency and collaboration in our development process. We greatly appreciate any contributions members of our community can provide. Whether you're fixing bugs, proposing features, improving documentation, or spreading awareness - your involvement strengthens the project.

• Bug Report: If you're experiencing an issue while using these images, please create an issue⁠.
• Security Report: Report critical security issues via our responsible disclosure policy⁠.

Need help getting started? Join our Discord community and we'll help you out!

⁠Our Sponsors

All of our software is free and open to the world. None of this can be brought to you without the financial backing of our sponsors.

⁠Black Level Sponsors

⁠Bronze Sponsors

⁠Individual Supporters

⁠About Us

We're Dan⁠ and Jay⁠ - a two-person team with a passion for open source products. We created Server Side Up⁠ to help share what we learn.

Dan Pastori	Jay Rogers

⁠Find us at:

• 📖 Blog⁠ - Get the latest guides and free courses on all things web/mobile development.
• 🙋 Community⁠ - Get friendly help from our community members.
• 🤵‍♂️ Get Professional Help⁠ - Get video + screen-sharing support from the core contributors.
• 💻 GitHub⁠ - Check out our other open source projects.
• 📫 Newsletter⁠ - Skip the algorithms and get quality content right to your inbox.
• 🐥 Twitter⁠ - You can also follow Dan⁠ and Jay⁠.
• ❤️ Sponsor Us⁠ - Please consider sponsoring us so we can create more helpful resources.

⁠Our Products

If you appreciate this project, be sure to check out our other projects.

⁠📚 Books

• The Ultimate Guide to Building APIs & SPAs⁠: Build web & mobile apps from the same codebase.
• Building Multi-Platform Browser Extensions⁠: Ship extensions to all browsers from the same codebase.

⁠🛠️ Software-as-a-Service

• Bugflow⁠: Get visual bug reports directly in GitHub, GitLab, and more.
• SelfHost Pro⁠: Connect Stripe or Lemonsqueezy to a private docker registry for self-hosted apps.

⁠🌍 Open Source

• AmplitudeJS⁠: Open-source HTML5 & JavaScript Web Audio Library.
• Spin⁠: Laravel Sail alternative for running Docker from development → production.
• Financial Freedom⁠: Open source alternative to Mint, YNAB, & Monarch Money.