●Change8

Migrating to Traefik v3.4.0

Version v3.4.0 introduces 1 breaking change. This guide details how to update your code.

Released: 5/5/2025

1
Breaking Changes
3
Migration Steps
22
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

acmedockerecsdocker/swarmconsulcatalognomadk8s/crdk8s/gatewayapiTLSRoutek8s/ingressmiddlewareforwardAutherror page middlewareRedis rate limiterservicesticky-sessiontlsudpsystemd socket activationwebuidefaultRuleSyntaxruleSyntax

Breaking Changes

●Issue #1

The default load-balancing strategy for Kubernetes CRD resources has been removed. Users relying on the previous default must explicitly configure a load-balancing strategy (e.g., round-robin, p2c) in their CRDs.

Migration Steps

  1. 1
    Read the migration guide: https://doc.traefik.io/traefik/master/migration/v3/#v33-to-v34.
  2. 2
    If using Kubernetes CRDs, explicitly configure a load-balancing strategy as the default has been removed.
  3. 3
    Review configuration for deprecated options defaultRuleSyntax and ruleSyntax.

Release Summary

Traefik v3.4 introduces significant enhancements across providers (Docker, K8s, Nomad) and middlewares, including a new Redis rate limiter and p2c load balancing, while removing the default load-balancing strategy for CRDs.

Need More Details?

View the full release notes and all changes for Traefik v3.4.0.

View Full Changelog