Caddy v2.0.0-beta.13 Release Notes
Release Date: 2020-01-22 // over 4 years ago-
๐ Caddy 2.0 beta 13 is the next pre-release in the development cycle of Caddy 2 and is the best one yet! We recommend that everyone on the beta track upgrade.
๐ We spent a LOT of time and effort improving the v2 Caddyfile for this release! It's not 100% finished yet but it is much closer. We've also updated the website with a lot of new documentation and tutorials. Check it out!
๐ โ ๏ธ This release contains some very helpful breaking changes. โ ๏ธ
Click here for details about the significant changes in beta 13.
๐ฑ Some highlights (breaking changes indicated by โ ๏ธ):
- ๐ฑ โ ๏ธ Path matching is now exact by default, not prefix
- ๐ฑ โ ๏ธ The
rewrite
Caddyfile directive is mutually exclusive with otherrewrite
directives - ๐ฑ โ ๏ธ Caddyfile matcher syntax has changed from
matcher
andmatch:
to simply@
- ๐ฑ โ ๏ธ Environment variables in the Caddyfile can be substituted at either adapt-time or runtime
- ๐ฑ โ ๏ธ HTTP route matchers are evaluated sequentially instead of all at once
- ๐ฑ โ ๏ธ New
order
Caddyfile option replaceshandler_order
- ๐ฑ โ ๏ธ
redir
Caddyfile directive now comes beforerewrite
directive - ๐ฑ โ ๏ธ
The
headersCaddyfile directive was renamed to
header` - ๐ New
route
Caddyfile directive evaluates directives in appearance order - ๐ New
handle
Caddyfile directive enables more sophisticated route composition - Caddyfile adapter will sort multiple instances of a directive by descending specificity of path matcher
- The
caddy
command now assumes thecaddyfile
adapter if config filename starts withCaddyfile
- 0๏ธโฃ The
caddy reload
command no longer requires--config
flag for default Caddyfiles - Reverse proxy's buffering can be disabled with a flush interval of -1
- ๐ Fix reverse proxy circuit breaker's
type
parameter - ๐ Fix
http.handlers.rewrite
module's manipulation of URI and construction of query strings - ๐ Fix
try_files
directive when used with query strings - ๐ Many other significant improvements and fixes to the Caddyfile
- ๐ Numerous other bug fixes and minor enhancements all around
- More details of the big changes in issue #2981
๐ See all commits since beta 12 here.
๐ฑ ๐ Please consider sponsoring this project. I work on this full-time and our runway is extremely limited!
๐ Please remember that Caddy 2 beta releases are not yet feature-complete as development is ongoing, nor are they stable; there are likely to be some breaking changes between tags. We hope you will find ways to use Caddy 2 beta in production and report any issues you find!
Thank you to all of you who have reported bugs or requested features so far. We continue to make good progress.
This is a community effort, so please report bugs, join the discussion, and submit pull requests to be a part of the team!
๐ Support:
- ๐ Community forum to ask questions, get community support, and lend your help
- Issue tracker for bug reports and dev discussion
v2 Resources:
- ๐ฑ ๐ Getting Started
- ๐ ๐ Full documentation
- ๐ฑ ๐ Writing a Caddy 2 module