●Change8

Migrating to Consul Connect v1.22.0-rc1

Version v1.22.0-rc1 introduces 2 breaking changes. This guide details how to update your code.

Released: 9/30/2025

2
Breaking Changes
2
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

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

connectagentenvoy/v1/operator/utilizationsnapshot agentconsul-enterprisehttp handlercensus metricscliui

Breaking Changes

●Issue #1

Removed support for Consul's bundled Envoy version 1.31.10. Users must now rely on Envoy 1.35.3 or newer.

●Issue #2

Envoy startup failures due to TLS configuration are fixed by only configuring the TLS transport socket when the CA bundle is present (applies to Envoy v1.35+).

Migration Steps

  1. 1
    If you rely on Envoy version 1.31.10, you must upgrade to use Envoy 1.35.3 or newer.
  2. 2
    If you are using TLS configuration with Envoy 1.35+, ensure your CA bundle is present to avoid startup failures.

Release Summary

This release upgrades the bundled Envoy version to 1.35.3, introduces support for registering services with multiple ports, and enhances IPv6/dual-stack capabilities across the agent and CLI. It also includes several UI accessibility and bug fixes.

Need More Details?

View the full release notes and all changes for Consul Connect v1.22.0-rc1.

View Full Changelog