Change8

Migrating to HAProxy v3.4-dev10

Version v3.4-dev10 introduces 1 breaking change. This guide details how to update your code.

Released: 4/29/2026

1
Breaking Changes
1
Migration Steps
33
Affected Symbols

⚠️ Check Your Code

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

configthreadsmux-h2taskcompressionmux_quich3otelhatermxprt_qstrmssl/samplechecksacmelogsamplemuxessessionmux-h1schedclistreamappletnet_helperh2tcpcheckhttp-actproxyserversdebugssl_ckch.cssl_sock.cacme.ipstools

Breaking Changes

Issue #1

The default value for `max-threads-per-group` has been changed from an unspecified value to 16. If your application relies on the previous default, you may need to explicitly configure this setting.

Migration Steps

  1. 1
    If your application relies on the previous default value for `max-threads-per-group`, explicitly configure this setting.

Release Summary

Version 3.4-dev10 introduces several bug fixes, minor improvements, and new features across various modules including OTel, ACME, muxing protocols, and stream handling. Notably, the default max-threads-per-group has been updated, and several memory leaks and protocol handling issues have been resolved.

Need More Details?

View the full release notes and all changes for HAProxy v3.4-dev10.

View Full Changelog