2.0 beta 13

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 other rewrite directives
• ⚠️ Caddyfile matcher syntax has changed from matcher and match: 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 replaces handler_order
• ⚠️ redir Caddyfile directive now comes before rewrite directive
• ⚠️ The headers Caddyfile 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 the caddyfile adapter if config filename starts with Caddyfile
• 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

2.0 beta 12

Caddy 2.0 beta 12 is the next pre-release in the development cycle of Caddy 2 and is the best update yet! We recommend that everyone on the beta track upgrade.

Some highlights:

• Caddy now saves all config changes from the API so it can resume the last active config with the --resume flag
• Majorly improved documentation, and launched new docs site: ✨ https://caddyserver.com/docs/ ✨
• Changed data directory; migration is automatic (see #2955)
• Servers listening only on the HTTPS port will enable TLS automatically
• Several minor bug fixes

See all commits since beta 11 here.

💚 Please consider sponsoring this project!

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
• Caddyfile examples

2.0 beta 11

Caddy 2.0 beta 11 is the next pre-release in the development cycle of Caddy 2 and is the best update yet! We recommend that everyone on the beta track upgrade.

Some highlights:

• Support for automatic config documentation (new docs site should be ready soon!)
• Multiple fixes for @id usage in the admin API
• Enhancements to rewrite handler and request matchers
• Log can now output to arbitrary network sockets
• Improved TLS cert management at scale
• Improved templates handler; better markdown and "include" support
• Several other significant bug fixes

See all commits since beta 10 here.

💚 Please consider sponsoring this project!

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.

To learn how to get started, see the README on the v2 branch.

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:

• Quick Start
• Full documentation
• Writing a v2 config from scratch
• Caddyfile examples
• Writing a Caddy 2 module

2.0 beta 10

Caddy 2.0 beta 10 is the next pre-release in the development cycle of Caddy 2 and is the best update yet! Some highlights:

• NTLM proxying
• Log level and filenames support placeholders
• Access logs include response headers
• Improved caddy stop, caddy file-server, and caddy reverse-proxy commands
• Numerous other bug fixes and minor enhancements

See all commits since beta 9 here.

💚 Please consider sponsoring this project!

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.

To learn how to get started, see the README on the v2 branch.

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:

• Quick Start
• Full documentation
• Writing a v2 config from scratch
• Caddyfile examples
• Writing a Caddy 2 module

1.0.4

This patch release fixes a bug in the fastcgi middleware that could result in the static file server returning PHP files as plain text on Windows systems. Thank you to @MisterDuval for the report and suggested fix.

Dependencies lego, certmagic, and quic-go have also been updated to their latest versions.

2.0 beta 9

Caddy 2.0 beta 9 is the next pre-release in the development cycle of Caddy 2 and is the best update yet! Some highlights:

• Significant bug fixes, especially related to HTTP requests. (Got rid of those panics! Oops)
• Refactored the admin (API) endpoint code significantly, making many internal improvements and fixing several bugs.
• Added optional origin enforcement features to the API for added security.
• Improved config reload performance significantly.
• Fixed some bugs related to the Caddyfile.

See all commits since beta 8 here.

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.

To learn how to get started, see the README on the v2 branch.

💚 Please consider sponsoring this project!

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:

• Quick Start
• Full documentation
• Writing a v2 config from scratch
• Caddyfile examples
• Writing a Caddy 2 module

2.0 beta 8

Caddy 2.0 beta 8 is the next pre-release in the development cycle of Caddy 2 and is the best update yet! Some highlights:

• Logging! Caddy 2 has an exceptionally powerful, flexible, and high-performing log. Read the docs about logging.
• Rewrite handler can now quickly strip path prefix or suffix conveniently, and issue HTTP redirects
• Significant improvements to TLS certificate management, especially at large scale. Give Caddy 2 a million domains and it will gradually obtain certificates for them with built-in rate limiting and retries over the course of days or weeks.
• CI improvements, including continuous fuzzing.
• HTTP cache can be configured to work in a group/cluster setting.
• Several bug fixes, including a hotfix for silly bug in beta 7 (d'oh! 🤦‍♂️)

See all commits since beta 6 here.

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.

To learn how to get started, see the README on the v2 branch.

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:

• Quick Start
• Full documentation
• Writing a v2 config from scratch
• Caddyfile examples
• Writing a Caddy 2 module

2.0 beta 7

Matt made an oops on this release, it has a bug serving HTTP requests; please use beta 8 instead.

2.0 beta 6

Caddy 2.0 beta 6 is the next pre-release in the development cycle of Caddy 2 and is the biggest update yet! Some highlights:

• Migrated all WIP and completed enterprise features to open source, including:
  • /config and /id API endpoints, which enable config traversal (selective updates) and exporting current configuration
  • WIP cache plugin for HTTP responses
  • pem_loader plugin, for specifying TLS certs and keys directly in config
  • distributed_stek plugin, for high-performance TLS session resumption in clusters
  • Custom TLS certificate selection policies
  • WIP Starlark handler (embedded scripting language)
• New placeholders for RemoteAddr (client IP, etc.)
• HTTP basic authentication plugin
• reverse_proxy: Ability to customize ServerName value in TLS handshake to backends
• reverse_proxy: Dynamic backends using placeholders (variables) in dial address
• reverse_proxy: Minor optimization of MaxIdleConnsPerHost default value

See all commits since beta 4 here.

(We tagged beta 5 mid-cycle as a test, but made a mistake with a dependency so we're ignoring that tag.)

Be advised that the next beta release may be delayed as we transition a bunch of code to open source and work on a new website and official images/packages.

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've made good progress.

To learn how to get started, see the README on the v2 branch.

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:

• Quick Start
• Full documentation
• Writing a v2 config from scratch
• Caddyfile examples
• Writing a Caddy 2 module

2.0 beta 4

Caddy 2.0 beta 4 is the next pre-release in the development cycle of Caddy 2. Some highlights:

• Plugged in the JSON 5 and JSON-C config adapters
• New file-server and reverse-proxy commands for convenience
• reverse_proxy module: Make request retries configurable based on properties of the request
• adapt subcommand: Default --adapter value is "caddyfile"
• Several bug fixes

See all commits since previous tag here.

Be advised that the next beta release may be delayed as we transition a bunch of code to open source and work on a new website.

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've made good progress.

To learn how to get started, see the README on the v2 branch.

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:

• Quick Start
• Full documentation
• Writing a v2 config from scratch
• Caddyfile examples
• Writing a Caddy 2 module