$ ls ~/releases/caddy

Caddy upgrade guide

Before you upgrade Caddy, check what happened when we did. We install the previous version in a throwaway lab (Debian 13 container), add some data, upgrade the documented way, and record what broke and what didn't. We cover every stable release. Upstream releases: caddyserver/caddy.

latest tested2.11.9upgrade now

Upgrade if you serve PHP or FastCGI; otherwise it is a safe, quick swap, but check the breaking changes first.

versions covered
3
lab-tested
3
last lab run
2026-11-05

all Caddy releases we tested

  1. 2.11.9Upgrade if you serve PHP or FastCGI; otherwise it is a safe, quick swap, but check the breaking changes first.upgrade now
  2. 2.11.8Several security fixes (path escape via Host, PHP/FastCGI, file matcher); read the breaking changes first, but a basic file server upgraded cleanly.upgrade now
  3. 2.11.7Upgrade if you are on 2.11.6; the package upgrade was clean and the cookie placeholder regression is fixed in our lab.upgrade now