lewimbes/caddy-cloudflare repository overview

⁠Caddy with Cloudflare DNS plugin

Automatically builds and publishes multi‑architecture Docker images for Caddy⁠ with the caddy-dns/cloudflare⁠ module pre‑installed.

⁠✨ Why use this image?

• Cloudflare DNS provider built-in – use tls.dns.cloudflare, ACME DNS challenges, or ECH without rebuilding Caddy.
• Multi‑arch – runs on linux/amd64 and linux/arm64.
• Automatic rebuilds – whenever upstream caddy:latest changes.
• Available from Docker Hub (lewimbes/caddy-cloudflare) and GHCR (ghcr.io/lewimbes/caddy-cloudflare).

⁠📦 Quick start

# Pull the latest image
docker pull lewimbes/caddy-cloudflare:latest

# Or pin a specific version
docker pull lewimbes/caddy-cloudflare:2.10.0
docker pull lewimbes/caddy-cloudflare:2.10
docker pull lewimbes/caddy-cloudflare:2

⁠🛠️ Build it yourself

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t lewimbes/caddy-cloudflare:latest .

⁠🤖 How the workflow works

A single GitHub Actions workflow keeps the image fresh:

• Triggers

  • Any push to the main branch
  • A daily scheduled run that checks whether caddy:latest has changed upstream

• If an update is needed, the job:

  • builds Caddy with the Cloudflare DNS module for linux/amd64 and linux/arm64,
  • tags the result (latest, full semver, major‑minor, major),
  • pushes to Docker Hub and GHCR.

See auto-build-on-change.yml⁠ for full details.

⁠📝 License

This repository is licensed under the Apache License 2.0.
Caddy⁠, Caddy-Docker⁠ and the Cloudflare DNS provider⁠ are upstream Apache‑2.0 projects.

⁠Official resources

• Upstream project – https://caddyserver.com⁠
• Official Docker image – https://hub.docker.com/_/caddy⁠