●Change8

Migrating to Kuma v2.7.20

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

Released: 11/18/2025

2
Breaking Changes
1
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 to use the new path.

●Issue #2

Release tags now include a `v` prefix (e.g., `v2.7.20`). This affects how dependencies are referenced via tags.

Migration Steps

  1. 1
    If you are a Go project directly referencing Kuma as a dependency, update your import paths to use the new module path: `github.com/kumahq/kuma/v2`.

Release Summary

This release aligns Kuma with Go module versioning conventions by updating the module path to include /v2 and prefixing release tags with 'v'. It also includes dependency bumps and a fix for XDS keepalive configuration.

Need More Details?

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

View Full Changelog