nginx 1.31.5 control API returns structured HTTP 422 errors on failed reloads
A tester found that nginx 1.31.5's new control API, added to the open-source build in September 2026, lets operators reload configuration over HTTP. The API can be enabled with a command-line flag and is included in the official nginx 1.31.8 Docker image. When a deliberately broken config was reloaded, the API returned an HTTP 422 response with the compiler message as a JSON array, while the signal-based reload only produced an exit code and an error-log line. Both methods rejected the bad config and kept the previous one running, and the API was not faster than sending a signal. The main advantage of the API is therefore the structured error reporting that scripts can consume directly.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)
Log in to join the discussion and vote.
Log in