●Change8

Migrating to Kuma v2.11.8

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

Released: 11/14/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 has changed to `github.com/kumahq/kuma/v2`. Go projects directly referencing Kuma must update their import paths to use the new path.

●Issue #2

Release tags now include the 'v' prefix (e.g., 'v2.11.8' instead of '2.11.8'). This affects how dependencies are referenced via tags.

Migration Steps

  1. 1
    If you are a Go project directly depending on Kuma, update your module path imports from the old path to `github.com/kumahq/kuma/v2`.
  2. 2
    Ensure your dependency management tool recognizes release tags prefixed with 'v' (e.g., v2.11.8).

Release Summary

This patch release updates Go dependencies and introduces breaking changes to align Kuma's module path and release tags with Go versioning conventions, requiring updates for direct Go module consumers.

Need More Details?

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

View Full Changelog