Migrating to Caddy v2.11.0-beta.2
Version v2.11.0-beta.2 introduces 1 breaking change. This guide details how to update your code.
Released: 1/6/2026
1
Breaking Changes
1
Migration Steps
9
Affected Symbols
⚠️ Check Your Code
If you use any of these symbols, you need to read this guide:
caddyhttpcaddypkicaddytlscmdloggingnotifytracingtls.ca_pool.source.httptls.caBreaking Changes
●Issue #1
caddytls: Using tls.ca_pool.source.http in combination with tls.ca will now cause a panic instead of potentially misbehaving. Users must choose one or the other.
Migration Steps
- 1If you were using both tls.ca_pool.source.http and tls.ca in your configuration, update it to use only one method to avoid a panic.
Release Summary
This beta release introduces several enhancements, including ECH key rotation, a new request body placeholder, and improved logging options. It also resolves a bug related to wildcard site logging and updates several underlying dependencies.
Need More Details?
View the full release notes and all changes for Caddy v2.11.0-beta.2.
View Full Changelog