Editor’s note: This release blog should have been published a few weeks ago but slipped through the cracks, so we are publishing it together with the latest release blog!
If you set working_directory for core files, NGINX Open Source 1.31.8 catches an invalid path with nginx -t before you deploy. Portability improvements keep HTTP/3, HTTP priorities, and the Control API working on strict-alignment, 32-bit, big-endian, and Solaris platforms, and kernel TLS connections close without recv() alerts in the error log. The JSON parser’s API and the way a relative working_directory path resolves both change, so read the upgrade notes before you move to NGINX Open Source 1.31.8. Each community contribution is credited next to the change it made.
Release highlights
- Working directory validation: Catch an invalid
working_directorypath withnginx -tbefore you deploy. - Improved portability: Bring HTTP/3, HTTP priorities, and the Control API to more platforms.
- Stability and bug fixes: Updates to kernel TLS logging, LibreSSL session handling, HTTP/3 header parsing, Control API logging, and WebDAV, plus a JSON parser API change for module developers.
Working directory validation and prefix-relative paths
What’s new: NGINX now checks the working_directory path when it reads the configuration, so nginx -t reports an invalid directory. Before, worker processes exited at startup or during a reload and weren’t respawned. A relative path now resolves against the NGINX prefix instead of the directory NGINX was started from (nginx/nginx#1855).
Why it matters: A mistyped path shows up in nginx -t instead of when worker processes start, and a relative path points to the same place however NGINX is started.
Portability improvements for strict-alignment, 32-bit, big-endian, and Solaris platforms
What’s new: Four portability improvements keep NGINX working the same way on platforms that differ from x86-64 in memory alignment, integer width, byte order, or operating system. The Solaris and big-endian fixes ship in the same pull request.
- HTTP/3 no longer crashes on strict-alignment platforms: On platforms with strict alignment requirements, a
SIGBUSsignal could terminate worker processes that use HTTP/3. This fix comes from community contributor daewoo1109 (nginx/nginx#1317). - HTTP priority fields keep their valid parameters on 32-bit platforms: On 32-bit platforms, an integer above 2,147,483,647 in a
Priorityheader, as inPriority: u=5, x=3000000000, discarded the whole field, valid urgency included. NGINX now ignores only that value. Thanks to community contributor nishat-06 for this fix (nginx/nginx#1814). - NGINX builds on Solaris with the Control API: Building with
--with-control-apifailed on Solaris and illumos (nginx/nginx#1819). - Asynchronous socket mode works on 64-bit big-endian platforms: On these platforms, the call that switches a socket to asynchronous mode silently failed (nginx/nginx#1819).
Why it matters: If you run NGINX on one of these platforms, HTTP/3, HTTP priorities, and the Control API are on par with x86-64.
Stability and bug fixes
- Kernel TLS connections close without
recv()alerts: With kernel TLS on OpenSSL 3.2.0 or later, NGINX no longer logs “recv() failed (5: Input/output error)” alerts when it closes SSL connections (nginx/nginx#1788). - A negative SSL session length from LibreSSL is rejected: With LibreSSL and an upstream
zone, a failed memory allocation could crash a worker process while NGINX saved an upstream SSL session (nginx/nginx#1599). - NGINX no longer passes a null pointer for empty HTTP/3 field values: An HTTP/3 header field with an empty value no longer triggers the undefined behavior that UndefinedBehaviorSanitizer builds reported. Community contributor dgprivate wrote this fix (nginx/nginx#1701).
- Control API errors on accepted connections include the cause: If NGINX fails to set up an accepted Control API connection, the error log now gives the operating system’s reason. Developed by community contributor OskarEichler (nginx/nginx#1720).
- WebDAV COPY and MOVE restore the request URI after a mapping error: If NGINX can’t map a COPY or MOVE destination to a file, it now restores the original request URI, so an
error_pagebuilt from a variable resolves against the right request (nginx/nginx#1778). - A typo in the
configurescript is fixed: The fix corrects spacing in the script’s option handling and doesn’t change howconfigurebehaves. Thanks to community contributor osokin for this fix (nginx/nginx#1857).
Upgrade notes
Before upgrading to NGINX Open Source 1.31.8, please verify your normal application behavior does not rely on any of the items below:
- Third-party modules that use the JSON parser need an update: The JSON parser now reports keys and strings that contain escape sequences as separate events,
NGX_JSON_KEY_ESCAPEDandNGX_JSON_VALUE_STRING_ESCAPED, andngx_json_unescape_string()now decodes into a separate buffer. If you maintain a module that uses the parser, handle the new events and update yourngx_json_unescape_string()calls. Other users have nothing to do (nginx/nginx#1806). - A relative
working_directorypath resolves against the prefix: It used to resolve against the directory NGINX was started from. If you set a relative path, check that it still points where you expect, or use an absolute path, before you upgrade (nginx/nginx#1855). - Windows builds no longer include the I/O completion ports event method:
use iocp;and theiocp_threads,post_acceptex, andacceptex_readdirectives now stop NGINX at startup. If your configuration has any of them, remove them before you upgrade (nginx/nginx#1823).
Community recognition
To everyone who wrote code for NGINX Open Source 1.31.8, tested it, or reported a bug in it: thank you!
Community contributions
With work from five community members, NGINX Open Source 1.31.8 includes three fixes for HTTP/3 and HTTP priorities, clearer Control API error logging, and a configure fix. Each contribution is credited above, next to the change it made. Thanks to daewoo1109, dgprivate, nishat-06, OskarEichler, and osokin!
Get your name in NGINX Open Source 1.31.9
Fix a bug, pick up an open issue, or bring a feature you’ve built. The contributing guide covers the rest.
Getting started with NGINX Open Source 1.31.8
NGINX Open Source 1.31.8 is available now as source code and as binary packages for major Linux distributions.
- Download source and packages: Visit nginx.org.
- Release notes and changes: Read the full CHANGES log.
- Documentation: Visit the NGINX documentation.
For more release announcements and technical articles, see the NGINX Blog.


