Change8

Migrating to Linkerd edge-25.11.3

Version edge-25.11.3 introduces 1 breaking change. This guide details how to update your code.

Released: 11/27/2025

1
Breaking Changes
1
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

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

proxy-init imageproxy imagegateway.networking.k8s.io HTTPRoutespolicy.linkerd.io HTTPRoutes

Breaking Changes

Issue #1

The separate `proxy-init` image has been removed and merged into the main `proxy` image. If you were explicitly referencing the `proxy-init` image, you must now use the `proxy` image instead.

Migration Steps

  1. 1
    If you were explicitly using the `proxy-init` image, update your configurations to use the `proxy` image in its place.

Release Summary

This release merges the proxy-init image into the proxy image for simplification and fixes an issue where HTTPRoute timeouts were not being correctly honored for gateway API resources.

Need More Details?

View the full release notes and all changes for Linkerd edge-25.11.3.

View Full Changelog