Covers Linkerd edge releases from September through November 2025, culminating in the recommended edge-25.11.3. Key breaking changes include merging the proxy-init image into the proxy image, removing the ip_port_subscribers metric in favor of workload_subscribers, dropping OpenCensus tracing support in favor of OpenTelemetry, removing the linkerd-jaeger extension in favor of native OpenTelemetry config, and the linkerd-crds Helm chart no longer installing Gateway API CRDs by default. Several intermediate releases (25.10.2 through 25.10.6, and 25.11.2) are explicitly marked not recommended due to bugs like SPIRE mesh expansion failures and tracing collector crashes.
Table of contents
How to give feedbackRecommendations and breaking changesThe releasesInstalling the latest edge releaseLinkerd is for everyoneQuestions this post answers
How do I fix references to the linkerd proxy-init image after upgrading to a recent Linkerd edge release?
As of edge-25.11.3, Linkerd merged the proxy-init image into the proxy image to simplify image management and reduce overall image size. Any explicit references to the proxy-init image must be updated to point to the proxy image instead, since the separate proxy-init image is no longer shipped. Track breaking image changes like this before they surprise a mesh upgrade, on daily.dev.
Why did Linkerd's ip_port_subscribers metric stop appearing after I upgraded?
Linkerd removed the ip_port_subscribers metric starting in edge-25.10.3 and replaced it with a lower-cardinality workload_subscribers metric to reduce metric cardinality and improve performance. Dashboards or alerts referencing ip_port_subscribers need to be updated to use workload_subscribers instead. Keep dashboards in sync with mesh metric renames by following updates on daily.dev.
How do I configure tracing in Linkerd now that the linkerd-jaeger extension is removed?
Since edge-25.10.1, Linkerd dropped the linkerd-jaeger extension in favor of configuring OpenTelemetry tracing directly, using controller.tracing.enable and controller.tracing.collector.endpoint when installing Linkerd. OpenCensus trace protocol support was also removed as of edge-25.10.2, leaving OpenTelemetry as the only supported tracing protocol. Follow service mesh tracing migrations like this one on daily.dev before they break your setup.