●Change8

Migrating to Linkerd edge-25.8.2

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

Released: 8/7/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:

proxyInitlinkerd2-control-planelinkerd2-cni

Breaking Changes

●Issue #1

The default command for programming the routing table has switched from `iptables-legacy` to `iptables-nft`. To revert to the old behavior, set `proxyInit.iptablesMode: legacy` in the `linkerd2-control-plane` chart or `iptablesMode: legacy` in the `linkerd2-cni` chart.

Migration Steps

  1. 1
    If you require the legacy iptables mode, configure it explicitly: set `proxyInit.iptablesMode: legacy` in the `linkerd2-control-plane` chart or `iptablesMode: legacy` in the `linkerd2-cni` chart.

Release Summary

This RECOMMENDED release updates numerous dependencies and switches the default routing table programming command from iptables-legacy to iptables-nft, requiring configuration changes for users needing the legacy mode.

Need More Details?

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

View Full Changelog