●Change8

Migrating to Linkerd edge-25.9.4

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

Released: 9/25/2025

1
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

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

linkerd-crds Helm chartnative sidecar proxiesHTTPRoute RequestRedirect filters

Breaking Changes

●Issue #1

The `linkerd-crds` Helm chart no longer installs the Gateway API CRDs by default. To restore this behavior, set `installGatewayAPI=true` when installing the chart.

Migration Steps

  1. 1
    If you are running Linkerd 2.18/edge-25.4.4 or higher and previously relied on the `linkerd-crds` chart to install Gateway API CRDs, upgrading will not uninstall them. If you are upgrading from an earlier version, you must install the Gateway API CRDs manually if you require them.

Release Summary

This release is RECOMMENDED and introduces a breaking change where the `linkerd-crds` Helm chart no longer installs Gateway API CRDs by default. It fixes a critical bug related to stale endpoint data in native sidecar proxies and adds support for ReplacePrefixMatch in HTTPRoute filters.

Need More Details?

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

View Full Changelog