Change8

Migrating to NGINX release-1.29.4

Version release-1.29.4 introduces 1 breaking change. This guide details how to update your code.

Released: 12/9/2025

1
Breaking Changes
2
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

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

ngx_ssl_set_client_hello_callback()HTTP/2Proxy URI change handlingQUIC handshake

Breaking Changes

Issue #1

SSL: The interface of ngx_ssl_set_client_hello_callback() has changed. Users relying on the previous signature must update their callback implementation.

Migration Steps

  1. 1
    If you use custom SSL callbacks, review and update your implementation of ngx_ssl_set_client_hello_callback() to match the new interface.
  2. 2
    Ensure your build environment supports pcre 10.47 if you rely on specific PCRE features or compatibility.

Release Summary

Nginx 1.29.4 introduces major features like HTTP/2 to backend support and Encrypted Client Hello (ECH) integration. This release also contains several bug fixes, including resolving a segfault in proxy URI changes and fixing build issues with BoringSSL.

Need More Details?

View the full release notes and all changes for NGINX release-1.29.4.

View Full Changelog