●Change8

Migrating to HAProxy v3.3-dev12

Version v3.3-dev12 introduces 2 breaking changes. This guide details how to update your code.

Released: 11/8/2025

2
Breaking Changes
2
Migration Steps
26
Affected Symbols

⚠️ Check Your Code

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

QUICaes_gcm_encaes_gcm_decresolversstats-filebackendbuild-sslproxymux-h1mux-h2connectionscfgparseserverstick-tablesssl/ckchacmestconnstreamcountersstatsappletchannelconfigtoolscebtreepeers

Breaking Changes

●Issue #1

The 'master-worker' keyword in configuration files is now deprecated when used alone. To fix this, ensure 'master-worker' is used in conjunction with other relevant keywords or consider alternative configurations.

●Issue #2

The 'daemon' configuration option is no longer compatible with the '-Ws' flag. Adjust your configuration or command-line arguments to avoid this conflict.

Migration Steps

  1. 1
    If using 'master-worker' alone in your configuration, ensure it is used with other relevant keywords or adjust your configuration.
  2. 2
    If using the 'daemon' configuration option with the '-Ws' flag, modify your configuration or command-line arguments to avoid this incompatibility.

Release Summary

This release introduces automatic SSL on QUIC servers, optional AAD parameter support for AES-GCM, and various bug fixes including a crash fix on non-x86 platforms. Several configuration options and keywords have been deprecated or modified for improved compatibility and robustness.

Need More Details?

View the full release notes and all changes for HAProxy v3.3-dev12.

View Full Changelog