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 handshakeBreaking 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
- 1If you use custom SSL callbacks, review and update your implementation of ngx_ssl_set_client_hello_callback() to match the new interface.
- 2Ensure 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