●Change8

Migrating to Linkerd edge-25.8.3

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

Released: 8/14/2025

1
Breaking Changes
1
Migration Steps
2
Affected Symbols

⚠️ Check Your Code

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

policy-controller imagepolicyController.image (Helm value)

Breaking Changes

●Issue #1

The separate 'policy-controller' image has been eliminated and is now included in the main 'controller' image. Consequently, the 'policyController.image' Helm value is now ignored.

Migration Steps

  1. 1
    If you were explicitly configuring the 'policyController.image' Helm value, remove this configuration as it is now ignored.

Release Summary

This release consolidates the policy controller into the main controller image, removing the separate image, and introduces a new metric for TLS provider visibility. It also includes extensive dependency updates.

Need More Details?

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

View Full Changelog