Skip to content
Reverse Proxy

Traefik Releases

Track Traefik proxy releases and version lifecycle. Migration guidance for v2 to v3, provider compatibility, middleware changes, and Docker/Kubernetes integration updates.

Total Versions

Supported

Latest

Version Timeline

All tracked releases with lifecycle status and EOL dates.

Loading version data…

Lifecycle Timeline

Visual overview of active support and maintenance windows.

2.9
2.10
2.11
3.0
3.1
3.2
3.3
2022 2023 2024 2025 2026 2027 2028
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active
Maint
Active / LTS
Maintenance
Today

Upgrade Paths

Migration guidance between major versions — breaking changes, effort estimates, and tips.

v2.x v3.0 Medium Difficulty
Est. 2-4 hours for a typical deployment

Breaking Changes

  • Deprecated v2 fields removed (require migration)
  • Middleware chain configuration restructured
  • EntryPoints TLS configuration syntax changed
  • Docker provider label format updated for some features
  • Kubernetes CRD apiVersion bumped
  • Metrics moved to OpenTelemetry-native (Prometheus still supported)
  • Some CLI flags renamed or removed

Migration Notes

Traefik provides an official migration guide and a traefik-migration-tool CLI that scans your config and highlights breaking changes. Most configs need 10-30 line changes. The biggest gotcha is middleware chains: if you had custom retry/rateLimit middleware, review the new syntax. Test with --api.insecure and --log.level=DEBUG before going live.

v3.0/3.1 v3.2 Low Difficulty
Est. < 30 minutes

Breaking Changes

  • WASM plugin improvements (may affect custom plugins)
  • Enhanced HTTP/3 connection handling
  • Updated default timeouts

Migration Notes

Minor version upgrades within v3 are smooth. Update the image tag, review the changelog for any deprecation warnings, restart. No config changes needed for standard setups.

Version Risk Assessment

Evaluate risk factors before choosing a version for production.

Version EOL Risk CVE Risk Ecosystem Cloud Support Overall Recommended Action
Traefik 2.9 and older Critical High Abandoned Degrading Critical No patches — upgrade to v3 immediately
Traefik 2.10 Critical High Unsupported Full Critical Past EOL — no patches
Traefik 2.11 High Medium Maintenance Full High Security-only patches — migrate to v3
Traefik 3.0 Medium Low Supported Full Medium Upgrade to latest 3.x for new features
Traefik 3.1 Low Low Active Full Low Supported — on upgrade path
Traefik 3.2 Low Low Active Full Low Current stable — recommended

Risk assessment based on Traefik Labs support policy, security patch availability, and provider compatibility. Assessed March 2026.

Traefik Version Feature Comparison

Side-by-side feature differences across major versions.

Feature 2.10 2.11 3.0 3.1 3.2
HTTP/3 (QUIC) Experimental Experimental Stable Stable Enhanced
WASM plugins No No Experimental Stable Stable
OpenTelemetry tracing No Partial Native Native Native
Kubernetes Gateway API Experimental Experimental Stable Stable Enhanced
Docker provider Stable Stable Stable Stable Stable
Auto Let's Encrypt Stable Stable Stable Stable Stable
Consul Catalog provider Stable Stable Stable Stable Stable
Middleware chain v2 syntax v2 syntax v3 syntax v3 syntax v3 syntax
SPIFFE/mTLS support Experimental Experimental Stable Stable Stable
Metrics (Prometheus/OTEL) Prometheus Prometheus Both Both Both

Embed Badges

Add live Traefik status badges to your README, docs, or dashboard.

Health Status

Overall support health

Traefik Health Status
![Traefik Health Status](https://img.releaserun.com/badge/health/traefik.svg)

EOL Countdown

Next end-of-life date

Traefik EOL Countdown
![Traefik EOL Countdown](https://img.releaserun.com/badge/eol/traefik.svg)

Latest Version

Current stable release

Traefik Latest Version
![Traefik Latest Version](https://img.releaserun.com/badge/v/traefik.svg)

CVE Status

Known vulnerabilities

Traefik CVE Status
![Traefik CVE Status](https://img.releaserun.com/badge/cve/traefik.svg)

Frequently Asked Questions

Common questions about Traefik releases and lifecycle.

What changed in Traefik v3?
Traefik v3 (released April 2024) dropped the deprecated v2 configuration fields, moved to OpenTelemetry-native observability, added WASM plugin support, brought full HTTP/3 support, and overhauled the middleware chain configuration. The v2 to v3 migration requires config changes but no architectural rethink. Most breaking changes are renaming or moving config keys.
How long is Traefik v2 supported?
Traefik v2 entered maintenance mode when v3 launched. It receives security patches only, with no new features. Traefik Labs has not published a hard EOL date but has signaled that v2 security patches will continue through at least late 2025. Plan your migration to v3 now.
How does Traefik auto-discovery work?
Traefik watches container orchestrators (Docker, Kubernetes, Consul, etc.) and automatically creates routes based on labels or annotations. When a container starts with the right labels, Traefik picks it up within seconds. This is its killer feature compared to Nginx, which requires manual config or external tooling.
Should I use Traefik or Nginx for Kubernetes?
Traefik excels as a Kubernetes ingress controller thanks to its native CRD support (IngressRoute), automatic Let's Encrypt, and middleware chain. Nginx Ingress Controller is more battle-tested at extreme scale. For most clusters under 500 services, Traefik is simpler to operate. Above that, evaluate both under load.
What is Traefik Hub?
Traefik Hub is the commercial API management platform built on Traefik Proxy. It adds API gateway features, access control, API portal, and rate limiting as a managed layer. Open-source Traefik Proxy remains fully functional without Hub.
Does Traefik support gRPC and WebSocket?
Yes. Both gRPC and WebSocket have been supported since Traefik v2. In v3, gRPC load balancing and WebSocket connection handling were improved. No special configuration is needed beyond standard router rules.

Related Tools