From cff13d2a4f0ed232a6c658500d7ce6866cb9f9fb Mon Sep 17 00:00:00 2001 From: Spinnich Date: Mon, 7 Sep 2026 16:52:04 +0000 Subject: [PATCH 1/2] docs(env-vars): sync the WEB_SERVER_CONCURRENCY row "2 x CPU cores + 1" is gunicorn's guidance for sync workers and does not apply to RomM's UvicornWorker setup. Mirrors rommapp/romm#4385 so the published table is correct before the next pinned-ref bump regenerates it. Co-Authored-By: Claude Opus 5 --- docs/resources/snippets/env-vars.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/resources/snippets/env-vars.md b/docs/resources/snippets/env-vars.md index 6f9f043..023f083 100644 --- a/docs/resources/snippets/env-vars.md +++ b/docs/resources/snippets/env-vars.md @@ -159,16 +159,16 @@ ### Web Server -| Variable | Default | Required | Description | -| ---------------------------------- | ------- | :------: | ----------------------------------------------------------- | -| `WEB_SERVER_CONCURRENCY` | `1` | | Number of worker processes (recommended: 2 × CPU cores + 1) | -| `WEB_SERVER_TIMEOUT` | `300` | | Timeout for web server requests in seconds | -| `WEB_SERVER_KEEPALIVE` | `2` | | Keep-Alive connection wait time in seconds | -| `WEB_SERVER_MAX_REQUESTS` | `1000` | | Maximum requests a worker processes before restarting | -| `WEB_SERVER_MAX_REQUESTS_JITTER` | `100` | | Random jitter added to max requests value | -| `WEB_SERVER_WORKER_CONNECTIONS` | `1000` | | Maximum simultaneous clients per worker process | -| `WEB_SERVER_GUNICORN_WAIT_SECONDS` | `30` | | Seconds to wait for Gunicorn to start before giving up | -| `IPV4_ONLY` | `false` | | Bind only to IPv4 | +| Variable | Default | Required | Description | +| ---------------------------------- | ------- | :------: | -------------------------------------------------------------------------------------------------------------- | +| `WEB_SERVER_CONCURRENCY` | `4` | | Number of API worker processes, not background tasks; ~160MB RAM each, raise only for several concurrent users | +| `WEB_SERVER_TIMEOUT` | `300` | | Timeout for web server requests in seconds | +| `WEB_SERVER_KEEPALIVE` | `2` | | Keep-Alive connection wait time in seconds | +| `WEB_SERVER_MAX_REQUESTS` | `1000` | | Maximum requests a worker processes before restarting | +| `WEB_SERVER_MAX_REQUESTS_JITTER` | `100` | | Random jitter added to max requests value | +| `WEB_SERVER_WORKER_CONNECTIONS` | `1000` | | Maximum simultaneous clients per worker process | +| `WEB_SERVER_GUNICORN_WAIT_SECONDS` | `30` | | Seconds to wait for Gunicorn to start before giving up | +| `IPV4_ONLY` | `false` | | Bind only to IPv4 | ### Proxy From 00ba5e91bf5fdceab23466dbf5bf0b3c12a74a8b Mon Sep 17 00:00:00 2001 From: Georges-Antoine Assi Date: Tue, 8 Sep 2026 08:03:10 -0400 Subject: [PATCH 2/2] docs(env-vars): trim the WEB_SERVER_CONCURRENCY note Co-Authored-By: Claude Opus 5 (1M context) --- docs/resources/snippets/env-vars.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/resources/snippets/env-vars.md b/docs/resources/snippets/env-vars.md index 023f083..6a14b51 100644 --- a/docs/resources/snippets/env-vars.md +++ b/docs/resources/snippets/env-vars.md @@ -159,16 +159,16 @@ ### Web Server -| Variable | Default | Required | Description | -| ---------------------------------- | ------- | :------: | -------------------------------------------------------------------------------------------------------------- | -| `WEB_SERVER_CONCURRENCY` | `4` | | Number of API worker processes, not background tasks; ~160MB RAM each, raise only for several concurrent users | -| `WEB_SERVER_TIMEOUT` | `300` | | Timeout for web server requests in seconds | -| `WEB_SERVER_KEEPALIVE` | `2` | | Keep-Alive connection wait time in seconds | -| `WEB_SERVER_MAX_REQUESTS` | `1000` | | Maximum requests a worker processes before restarting | -| `WEB_SERVER_MAX_REQUESTS_JITTER` | `100` | | Random jitter added to max requests value | -| `WEB_SERVER_WORKER_CONNECTIONS` | `1000` | | Maximum simultaneous clients per worker process | -| `WEB_SERVER_GUNICORN_WAIT_SECONDS` | `30` | | Seconds to wait for Gunicorn to start before giving up | -| `IPV4_ONLY` | `false` | | Bind only to IPv4 | +| Variable | Default | Required | Description | +| ---------------------------------- | ------- | :------: | ------------------------------------------------------------------ | +| `WEB_SERVER_CONCURRENCY` | `4` | | Number of API worker processes, raise for several concurrent users | +| `WEB_SERVER_TIMEOUT` | `300` | | Timeout for web server requests in seconds | +| `WEB_SERVER_KEEPALIVE` | `2` | | Keep-Alive connection wait time in seconds | +| `WEB_SERVER_MAX_REQUESTS` | `1000` | | Maximum requests a worker processes before restarting | +| `WEB_SERVER_MAX_REQUESTS_JITTER` | `100` | | Random jitter added to max requests value | +| `WEB_SERVER_WORKER_CONNECTIONS` | `1000` | | Maximum simultaneous clients per worker process | +| `WEB_SERVER_GUNICORN_WAIT_SECONDS` | `30` | | Seconds to wait for Gunicorn to start before giving up | +| `IPV4_ONLY` | `false` | | Bind only to IPv4 | ### Proxy