Caddy-Modular

Caddy-Modular

Docker app from Jelle's Repository

Overview

This container builds and runs the latest version of Caddy with the specified modules included. This allows you to run Caddy with any of the modules available here: https://caddyserver.com/docs/modules. For when you want to: * Use your own DNS provider for the DNS TLS-ALPN challenge * DuckDNS * Cloudflare * Hetzner * And many more... * Use a different storage backend * Redis * MySQL * Postgres * Use other authentication providers * Discord * JWT * LDAP * OAuth 2.0 * Set up caching * Redis * Integrate security enhancements * Fail2Ban * Crowdsec * Geoblocking * Block bots and crawlers * Collect metrics * Prometheus * Umami * Run caddy with your own custom modules * Or use any of the other registered caddy modules * https://caddyserver.com/docs/modules * Based on the latest official alpine caddy builder image. Planned Features: * Storing the build binary to speed up restarts

Readme

View on GitHub

Caddy-Modular

This container builds and runs the latest version of Caddy with the specified modules included.
This allows you to run Caddy with any of the modules available here: https://caddyserver.com/docs/modules.

Usecases

For when you want to:

  • Use your own DNS provider for the DNS challenge
    • DuckDNS
    • Cloudflare
    • Hetzner
    • And many more...
  • Use a different storage backend
    • Redis
    • MySQL
    • Postgres
  • Use other authentication providers
    • Discord
    • JWT
    • LDAP
    • OAuth 2.0
  • Set up caching
    • Redis
  • Integrate security enhancements
    • Fail2Ban
    • Crowdsec
    • Geoblocking
    • Block bots and crawlers
  • Collect metrics
    • Prometheus
    • Umami
  • Run caddy with your own custom modules
  • Or use any of the other registered caddy modules

Tutorials

This section is incomplete. You can help by submitting your own tutorials as a pull request.

List of tutorials to help you get started. All tutorials assume you are running this container on unraid 7 or higher.

Install Caddy-Modular on Unraid in a few clicks.

Find Caddy-Modular in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Caddy-Modular Review the template variables and paths Click Install
Explore Unraid OS

Requirements

Example Caddyfile is created on first run and can be found at appdata location.
Check the ReadMe for tutorials.
Default port assignment can conflict with unraid WebUI.
Caddy cannot perform TLS challenges on ports other than 80 and 443.
The unraid WebUI port settings can be changed at Settings/Management Access.

Categories

Network > WebNetwork > ProxyTools > Utilities

Related apps

Explore more like this

Explore all
Web appsProxy appsUtilities apps

Links

Projectcaddyserver.comSupportgithub.comRegistrygithub.comTemplateraw.githubusercontent.com

Details

Repository
ghcr.io/snellejelle99/caddy-modular
Registry
https://github.com/snellejelle99/caddy-modular
Last Updated2026-07-15
First Seen2026-06-03

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--cap-add=NET_ADMIN

Template configuration

Appdata and CaddyfilePathrw
Target
/etc/caddy
Default
/mnt/user/appdata/caddy-modular/
Value
/mnt/user/appdata/caddy-modular/
HTTP 80Porttcp
Target
80
Default
80
Value
80
TLS 443Porttcp
Target
443
Default
443
Value
443
HTTP/3 portPortudp
Target
443
Default
443
Value
443
Admin API portPorttcp
Target
2019
Default
2019
Value
2019
Variable: CADDY_MODULESVariable{3}

List of caddy modules you want installed. Example: --with {module_url1} --with {module_url2}

Target
CADDY_MODULES
Default
--with github.com/caddy-dns/duckdns --with github.com/caddy-dns/hetzner/v2 --with github.com/caddy-dns/cloudflare
Variable: DNS_API_TOKENVariable{3}

Your dns providers API token for automatic TLS certificate issuance and renewal.

Target
DNS_API_TOKEN