# caddyserver/caddy · Reposen Release & Migration Intelligence

> Patches critical FastCGI security vulnerabilities and routing regressions. Update immediately. Migration: Low.

## Metadata
- **Repository URL**: https://github.com/caddyserver/caddy
- **Primary Package**: `github.com/caddyserver/caddy/v2` (GO)
- **Categories**: `BACKEND`, `RUNTIME`
- **Latest Version**: `v2.11.9`
- **Semantic Status**: `SECURITY_PATCH`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/caddyserver/caddy/releases.atom

## The Human Context (Plain-English Pitch)
Caddy is an extensible, enterprise-ready web server with automatic HTTPS capabilities written in Go. It simplifies web infrastructure configuration through intuitive Caddyfiles and automated certificate management. This release addresses critical security advisories in FastCGI handling and fixes directory index routing regressions for PHP applications.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Patches critical FastCGI security vulnerabilities and routing regressions. Update immediately. Migration: Low.

## Breaking Changes & Required Actions
- [BREAKING] Conflicting `client_auth` definitions across shared TLS connection policies now throw a Caddyfile error.
- [BREAKING] Ambiguous FastCGI script paths with mismatched escaped and decoded forms now trigger a `400` response.
- [BREAKING] FastCGI `env` configuration values now strictly take precedence over incoming client request headers.
- Fixed PHP directory index resolution regressions introduced in `v2.11.8` for trailing slash requests.
- Patched multiple critical FastCGI security bypasses involving header spoofing, Windows 8.3 paths, and encoded dot segments.
- Enforced strict validation on conflicting `client_auth` declarations within TLS connection policies.
- Updated `go-jose` dependency to `v4.1.6` addressing `GHSA-mgcc-cww5-fp2q`.

## Migration Snippet
```ts
go get github.com/caddyserver/caddy/v2@v2.11.9
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **Go Runtime >= 1.22** [`COMPATIBLE`]: Requires standard Go toolchain compilation compatible with recent Go runtime versions.

## Zero-Noise Release Timeline
- **v2.11.9** (2026-11-05) [SECURITY_PATCH]: Patches critical FastCGI security vulnerabilities and routing regressions. Update immediately. Migration: Low.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is caddyserver/caddy v2.11.9 safe to upgrade in production?
caddyserver/caddy v2.11.9 is classified as SECURITY_PATCH (PATCH release). Patches critical FastCGI security vulnerabilities and routing regressions. Update immediately. Migration: Low.

### What breaking changes or compatibility risks exist in caddyserver/caddy v2.11.9?
Conflicting `client_auth` definitions across shared TLS connection policies now throw a Caddyfile error. Ambiguous FastCGI script paths with mismatched escaped and decoded forms now trigger a `400` response. FastCGI `env` configuration values now strictly take precedence over incoming client request headers.

### What is the bundle size impact of github.com/caddyserver/caddy/v2 v2.11.9?
Measured bundle size telemetry is currently unavailable for github.com/caddyserver/caddy/v2 v2.11.9; verify build output locally before deploying.

### How do I upgrade github.com/caddyserver/caddy/v2 to v2.11.9?
Upgrade github.com/caddyserver/caddy/v2 to v2.11.9 by running "go get github.com/caddyserver/caddy/v2@v2.11.9" and applying the migration steps: go get github.com/caddyserver/caddy/v2@v2.11.9
