# Linkerd edge-25.12.3

2025-12-18 · [Original release notes](https://github.com/linkerd/linkerd2/releases/tag/edge-25.12.3) · [Full summary](https://ratatosk.io/en/releases/linkerd/edge-25.12.3)

Breaking changes 1 · Important fixes 3 · Dependency updates 10 · Other changes 6

## Breaking changes (1)

### linkerd-cni default image version updated to `v1.6.5`

- Affects: CNI plugin deployments using the chart or generated install manifests and relying on the default image version (Inferred)

The CNI chart's image version default was `v1.6.4`.

Evidence: “- version: "v1.6.4" + version: "v1.6.5"” https://github.com/linkerd/linkerd2/pull/14816

> * chore(deps): bump proxy-init(v2.4.4), linkerd-cni(v1.6.5) and validator(0.1.5) by @alpeb in https://github.com/linkerd/linkerd2/pull/14816

## Important fixes (3)

### Native-sidecar opaque ports surfaced by the `Get` API

- Affects: native sidecars with ports marked opaque in `Server` resources that refer to those ports by name

When a `Server` referred to a native-sidecar port by name, the `Get` API omitted its opaque-port information.

> This release correctly discovers ports and port opacity when using native sidecars, and fixes a race condition in the CNI plugin that could prevent proper deployment in some environments, particularly EKS.
> * fix(destination): properly discover native sidecar ports by @alpeb in https://github.com/linkerd/linkerd2/pull/14814

### Native-sidecar opaque-port detection fixed

- Affects: direct-IP pod access with native-sidecar ports marked opaque by `config.linkerd.io/opaque-ports`

Previously, `getProfile` skipped init containers, leaving annotated native-sidecar ports unmarked as opaque. It now includes their ports when interpreting the annotation.

> * fix(destination): properly deal with native sidecar port opacity in getProfile by @alpeb in https://github.com/linkerd/linkerd2/pull/14791
> This release correctly discovers ports and port opacity when using native sidecars, and fixes a race condition in the CNI plugin that could prevent proper deployment in some environments, particularly EKS.

### CNI plugin deployment race fixed

- Affects: setups using the CNI plugin, particularly on EKS

In some environments, particularly EKS, the race condition could prevent proper deployment. That deployment-preventing race is fixed in this release.

> This release correctly discovers ports and port opacity when using native sidecars, and fixes a race condition in the CNI plugin that could prevent proper deployment in some environments, particularly EKS.

## Dependency updates (10)

10 more, none mentioning security

- `* build(deps): bump google.golang.org/protobuf from 1.36.10 to 1.36.11 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14805`
- `* build(deps): bump tokio-metrics from 0.4.5 to 0.4.6 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14784`
- `* build(deps): bump helm.sh/helm/v3 from 3.19.2 to 3.19.4 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14804`
- `* build(deps): bump indexmap from 2.12.0 to 2.12.1 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14785`
- `* chore(deps): bump proxy-init(v2.4.4), linkerd-cni(v1.6.5) and validator(0.1.5) by @alpeb in https://github.com/linkerd/linkerd2/pull/14816`
- `* chore(deps): bump proxy-init(v2.4.4), linkerd-cni(v1.6.5) and validator(0.1.5) by @alpeb in https://github.com/linkerd/linkerd2/pull/14816`
- `* build(deps): bump the kube group with 7 updates by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14797`
- `* build(deps): bump rustls-pki-types from 1.13.0 to 1.13.1 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14810`
- `* build(deps): bump socket2 from 0.6.0 to 0.6.1 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14811`
- `* build(deps): bump hostname from 0.4.1 to 0.4.2 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14787`

## Other changes (6)

- cli-setup GitHub Action updates `actions/download-artifact` to 7.0.0
- GitHub action `dessant/lock-threads` updated from 5.0.1 to 6.0.0
- `actions/download-artifact` updated to 7.0.0
- `actions/upload-artifact` updated to 6.0.0
- `/web/app` `webpack-bundle-analyzer` dependency updated to 5.1.0
- `tj-actions/changed-files` updated

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
