●Change8

Migrating to Kuma v2.12.4

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

Released: 11/14/2025

2
Breaking Changes
2
Migration Steps
0
Affected Symbols

Breaking Changes

●Issue #1

The module path for Kuma dependencies has changed to `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.12.4`). This affects dependency management if tags are used directly.

Migration Steps

  1. 1
    If you are using Kuma as a Go dependency, update your import paths to use the new module path: `github.com/kumahq/kuma/v2`.
  2. 2
    If you rely on release tags directly, update your tooling to look for tags prefixed with 'v' (e.g., `v2.12.4`).

Release Summary

This release introduces breaking changes to align Kuma's module path and release tags with Go module versioning conventions, alongside several bug fixes and performance improvements.

Need More Details?

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

View Full Changelog