From a141f7f771ba81e6a3e8db83c13d7a8ae23dcff7 Mon Sep 17 00:00:00 2001 From: Arthur Hanson Date: Thu, 25 Jan 2024 05:41:01 -0800 Subject: [PATCH] 14691 add documentation for gunicorn bug (#14924) * 14691 add documentation for gunicorn bug * Update docs/installation/4-gunicorn.md --------- Co-authored-by: Jeremy Stretch --- docs/installation/4-gunicorn.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/installation/4-gunicorn.md b/docs/installation/4-gunicorn.md index 1183a9123..e31c48466 100644 --- a/docs/installation/4-gunicorn.md +++ b/docs/installation/4-gunicorn.md @@ -58,3 +58,6 @@ You should see output similar to the following: If the NetBox service fails to start, issue the command `journalctl -eu netbox` to check for log messages that may indicate the problem. Once you've verified that the WSGI workers are up and running, move on to HTTP server setup. + +!!! note + There is a bug in the current stable release of gunicorn (v21.2.0) where automatic restarts of the worker processes can result in 502 errors under heavy load. (See [gunicorn bug #3038](https://github.com/benoitc/gunicorn/issues/3038) for more detail.) Users who encounter this issue may opt to downgrade to an earlier, unaffected release of gunicorn (`pip install gunicorn==20.1.0`). Note, however, that this earlier release does not officially support Python 3.11.