Traefik 3.2.0 → 3.3.0
5 versions, 4 migration-guide sections in 3 versions, 0 required stops
Version by version, oldest first
3.2.1 2024-11-20
Migration
X-Forwarded-Prefix Header Changes
In v3.2.1, the X-Forwarded-Prefix header is now handled like other X-Forwarded-* headers - Traefik removes it when sent from untrusted sources.
This change improves security by preventing header spoofing from untrusted clients. Refer to the Forwarded headers documentation for configuration details.
From doc.traefik.io/traefik/migrate/v3/#x-forwarded-prefix-header-changes
3.2.2 2024-12-10
Migration
Swarm Provider Label Updates
In v3.2.2, Swarm-specific labels have been deprecated and will be removed in a future version.
Migration Required:
| Deprecated Label | New Label |
|---|---|
traefik.docker.network | traefik.swarm.network |
traefik.docker.lbswarm | traefik.swarm.lbswarm |
From doc.traefik.io/traefik/migrate/v3/#swarm-provider-label-updates
3.2.3 – 3.2.4: no action items (2 versions)
3.2.5: released after 3.3.0; not on this route
3.3.0 2025-01-06
Migration
ACME DNS Certificate Resolver
In v3.3, DNS challenge configuration options have been reorganized for better clarity.
Migration Required:
| Deprecated Option | New Option |
|---|---|
acme.dnsChallenge.delaybeforecheck | acme.dnsChallenge.propagation.delayBeforeChecks |
acme.dnsChallenge.disablepropagationcheck | acme.dnsChallenge.propagation.disableChecks |
From doc.traefik.io/traefik/migrate/v3/#acme-dns-certificate-resolver
Migration
Tracing Global Attributes
In v3.3, the tracing configuration has been clarified to better reflect its purpose.
Migration Required:
- Old:
tracing.globalAttributes - New:
tracing.resourceAttributes
The old option name was misleading as it specifically adds resource attributes for the collector, not global span attributes.
From doc.traefik.io/traefik/migrate/v3/#tracing-global-attributes
Release notes from github.com/traefik/traefik/blob/master/CHANGELOG.md, and Migration: Steps needed between the versions, checked 17 hours ago. Only text the vendor marks as breaking, or puts in a warning/caution/important note, is shown; read the full notes for anything else. Traefik's release notes (CHANGELOG.md, GitHub releases) are lists of merged pull requests and mark nothing as breaking. What is quoted instead is Traefik's migration documentation on doc.traefik.io: “Migration: Steps needed between the versions” (v3), the same page of the v2.11 documentation (v2), and “Configuration Details for Migrating from Traefik v2 to v3” (on 3.0.0). Each section of those pages is labelled “Migration” and shown on the release its heading names (“v3.3 to v3.4” on 3.4.0). A section naming a canceled release (v2.4.10, v2.9.0) is shown on the next release of that line. Versions are covered from 2.0.0. No required stop is documented.