Caddy (web server)

From Wikipedia, the free encyclopedia
Jump to navigation Jump to search
Caddy Logo.svg
Original author(s)Matthew Holt
Initial release28 April 2015; 3 years ago (2015-04-28)
Stable release
0.11.4 / 15 February 2019; 33 days ago (2019-02-15)
Repository Edit this at Wikidata
Written inGo[1]
Operating systemAndroid, BSD variants, Linux, Plan 9, OS X and Windows
TypeWeb server, reverse proxy server
LicenseApache 2

Caddy, sometimes clarified as the Caddy web server, is an open source, HTTP/2-enabled web server written in Go. It uses the Go standard library for its HTTP functionality.[1]

One of Caddy's most notable features is enabling HTTPS by default.[2][3][4]

The author, Matt Holt, began developing Caddy in December 2014 and released it in April 2015.[5]

Caddy supports a variety of Web technologies and is available as statically-compiled binaries for Windows, Mac, Linux, Android, and BSD operating systems on i386, amd64, and ARM architectures.


A variety of web site technologies can be served by Caddy, which can also act as a reverse proxy and load balancer. Most of Caddy's features are implemented as middleware and exposed through directives in the Caddyfile (a text file used to configure Caddy).[6]

  • HTTP/1.1 (plaintext HTTP) and HTTP/2 (default for HTTPS connections)
  • HTTPS, either automatically enabled and managed, or manually configured
  • Virtual hosting (multiple sites on the same port)[8]
  • Native IPv4 and IPv6 support
  • Serve static files (uses sendfile where possible)
  • Graceful restart/reload
  • Reverse proxy (HTTP or WebSockets)
  • Load balancing with health checks
  • FastCGI proxy[9][10]
  • Templates (similar to Server Side Includes)
  • Markdown rendering
  • CGI via WebSockets
  • Gzip compression
  • Basic access authentication
  • URL rewriting
  • Redirects
  • File browsing
  • Access, error, and process logs
  • Experimental QUIC Support


Caddy is not vulnerable to a number of widespread CVEs including Heartbleed, DROWN, POODLE, and BEAST.[11] In addition, Caddy uses TLS_FALLBACK_SCSV to prevent protocol downgrade attacks.

On June 2, 2015, version 0.7.1 was released to patch a vulnerability to timing attacks in Caddy's basic authentication middleware.[12]

With regards to protocols and cipher suites, Caddy uses TLS 1.0-1.2 and prefers ECDHE ECDSA with AES-256 GCM SHA-384, although a dozen different ciphers are supported. Caddy has also been used by Cloudflare as a platform to serve an experimental TLS 1.3 implementation.[13]

Traditional privilege de-escalation as performed in C programs is non-trivial in Go programs.[14] In order to bind ports lower than 1024, Caddy must be run as root (not recommended) or given capabilities to bind to low ports using setcap (recommended). However, an alternate method of dropping privileges that involves spawning an unprivileged child process will likely be implemented in a future version.[15]

Caddy does not automatically enable HTTP Strict Transport Security; it is recommended that users enable HSTS using Caddy's header directive.[16]

Automatic HTTPS[edit]

Caddy activates HTTPS by default for sites with qualifying domain names (names for which a TLS certificate can be negotiated via the ACME protocol), and redirects HTTP requests to HTTPS.[17] It obtains certificates as needed during startup and keeps them renewed during the lifetime of the server. Let's Encrypt is the default certificate authority, but the user may customize the ACME CA that is used, which is often necessary when testing configurations. As of Q1 2016, Caddy accounted for about 2% of certificates issued by Let's Encrypt.[18]

An alternate configuration allows Caddy to obtain certificates only as needed during TLS handshakes rather than at startup, a feature dubbed "On-Demand TLS."[19] To enable this feature, the user must specify a maximum number of certificates that can be issued this way. When Caddy receives a request for a hostname for which it does not yet have a certificate, it will negotiate a new certificate via ACME and serve it immediately, while caching the obtained certificate in memory and storing it on disk. This process usually takes a few seconds, and is subject to tight rate limits.[19]

When serving TLS, Caddy will automatically rotate session ticket keys periodically to help preserve perfect forward secrecy.[20]


Starting version 0.11, Caddy has telemetry.[21] This is opt-in (disabled by default) when downloading Caddy from the official website, and opt-out (enabled by default) when building from source.[22]


  1. ^ a b Gerrand, Andrew (17 February 2016). "Go 1.6 is released". Retrieved 5 March 2016.
  2. ^ Johnson, Brad (23 February 2016). "A Better Web Server with Free SSL". Retrieved 5 March 2016.
  3. ^ "Automatic HTTPS with Caddy Server". 18 December 2015. Retrieved 5 March 2016.
  4. ^ Aas, Josh (12 February 2016). NYLUG Presents: Josh Aas on Let's Encrypt: A Free, Automated, and Open CA. Bloomberg. 32 minutes in.
  5. ^ "Show HN: Caddy, a cross-platform HTTP/2 web server". 28 April 2015.
  6. ^ "The Caddyfile". Retrieved 29 February 2016.
  7. ^ "tls - Caddy Directives". Retrieved 8 March 2016.
  8. ^ Benedetti, Benoit (November 2015). "Caddy, Le Serveur Web Facile" [Caddy, The Easy Web Server]. GNU/Linux Magazine France (in French). France.
  9. ^ "How to Setup the Caddy Web Server with php-fpm". Archived from the original on 2017-08-18. Retrieved 2016-03-09.
  10. ^ Beke, Mathias (21 August 2015). "Caddy Server and WordPress (PHP-FPM)".
  11. ^ "SSL Server Test: (Powered by Qualys SSL Labs)". Retrieved 5 March 2016.
  12. ^ "Release 0.7.1 · mholt/caddy". 2 June 2015.
  13. ^ Nick Sullivan [@grittygrease] (4 Mar 2016). "It's built in Go using custom versions @rlbarnes's Mint and @mholt6's Caddy" (Tweet) – via Twitter.
  14. ^ "syscall: Setuid/Setgid doesn't apply to all threads on Linux". 21 January 2011. Retrieved 5 March 2016.
  15. ^ "Implement privilege de-escalation". 21 January 2016.
  16. ^ "HTTP Strict Transport Security". Retrieved 8 March 2016.
  17. ^ "Automatic HTTPS". Retrieved 5 March 2016.
  18. ^ Eckersley, Peter (21 February 2016). USENIX Enigma 2016 - Several Horror Stories about the Encrypted Web. USENIX. 13 minutes in.
  19. ^ a b "On-Demand TLS". Retrieved 5 March 2016.
  20. ^ Springall, Drew; Durumeric, Zakir; Halderman, J. Alex (2016-01-01). "Measuring the Security Harm of TLS Crypto Shortcuts". Proceedings of the 2016 ACM on Internet Measurement Conference. IMC '16. New York, NY, USA: ACM: 33–47. doi:10.1145/2987443.2987480. ISBN 9781450345262.
  21. ^ "Caddy 0.11 Will Have Telemetry". Caddy. 2018-03-30. Retrieved 2018-06-05.
  22. ^ "Caddy Telemetry - Documentation". Retrieved 20 February 2019.

External links[edit]