●Change8

Migrating to Kuma v2.10.9

Version v2.10.9 introduces 2 breaking changes. This guide details how to update your code.

Released: 11/18/2025

2
Breaking Changes
2
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

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

MeshCircuitBreakermeshpassthroughxds

Breaking Changes

●Issue #1

The module path for Kuma dependencies has changed to use the Go module versioning convention: it is now `github.com/kumahq/kuma/v2`. Go projects directly referencing Kuma must update their import paths.

●Issue #2

Release tags now include a 'v' prefix (e.g., `v2.10.9` instead of `2.10.9`). This affects how tags are referenced in dependency management.

Migration Steps

  1. 1
    If you are using Kuma as a direct Go dependency, update your import paths to use the new module path: `github.com/kumahq/kuma/v2`.
  2. 2
    When referencing release tags, ensure you include the 'v' prefix (e.g., use `v2.10.9`).

Release Summary

This release aligns Kuma with Go module versioning by updating the module path to include /v2 and prefixing release tags with 'v', alongside several bug fixes and dependency bumps.

Need More Details?

View the full release notes and all changes for Kuma v2.10.9.

View Full Changelog