Skip to content

OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.

Python

issue 909

April M350816d03486
diff --git a/docs/docs/reference/configuration.mdx b/docs/docs/reference/configuration.mdx
index 48a36b4b5..316abab34 100644
--- a/docs/docs/reference/configuration.mdx
+++ b/docs/docs/reference/configuration.mdx
@@ -155,9 +155,10 @@ Configure general system components, session management, and logging.
| `FRONTEND_PORT` | `3000` | Host port for the OpenRAG frontend web interface. Change this if port 3000 is already in use on your system. |
| `OPENRAG_VERSION` | `latest` | The version of the OpenRAG Docker images to run. For more information, see [Upgrade OpenRAG](/upgrade) |
| `NEXT_ALLOWED_DEV_ORIGINS` | `http://localhost:3000` | Only used when [running OpenRAG in development mode](/support/contribute). Accepts a comma-separated list of hostnames to allow additional origins to make requests to the Next.js development server. |
-| `MAX_WORKERS` | `min(4, CPU_COUNT // 2)` | Number of Backend worker processes for concurrent request handling. |
-| `LANGFLOW_WORKERS` | `1` | Number of Langflow worker processes for concurrent request handling. |
-| `DOCLING_WORKERS` | `1` | Number of Docling worker processes for concurrent request handling. |
+| `MAX_WORKERS` | `min(4, CPU_COUNT // 2)` | Number of Backend worker processes for concurrent request handling. Be mindful of hardware limitations to avoid overtaxing system resources. |
+| `LANGFLOW_WORKERS` | `1` | Number of Langflow worker processes for concurrent request handling. Be mindful of hardware limitations to avoid overtaxing system resources. |
+| `DOCLING_WORKERS` | `1` | Number of Docling worker processes for concurrent request handling. Be mindful of hardware limitations to avoid overtaxing system resources. |
+| `ACCESS_LOG` | `true` | Whether to enable access logging for OpenRAG services, such as `INFO: 127.0.0.1:45132 - "GET /tasks HTTP/1.1" 200 OK`. Access logs provide information about incoming requests, and they can be useful for monitoring and debugging. |
<!-- | `LOG_FORMAT` | Not set | Set to `json` to enabled JSON-formatted log output. If this variable isn't set, then the default logging format is used. | -->
<!-- | `LOG_LEVEL` | `INFO` | Logging level. Can be one of `DEBUG`, `INFO`, `WARNING`, or `ERROR`. `DEBUG` provides the most detailed logs but can impact performance. | -->
diff --git a/docs/docs/support/troubleshoot.mdx b/docs/docs/support/troubleshoot.mdx
index 5ff94d27b..3462e60e4 100644
--- a/docs/docs/support/troubleshoot.mdx
+++ b/docs/docs/support/troubleshoot.mdx
@@ -164,7 +164,7 @@ The minimum recommendation is 8 GB of RAM and at least 50 GB of free disk space,
If you regularly ingest large files, more RAM and space are recommended.
* If OCR ingestion fails due to OCR missing, see [OCR ingestion fails (easyocr not installed)](/support/troubleshoot#ocr-ingestion-fails-easyocr-not-installed).
-### Ingesting very large PDFs or folders with many documents
+### Timeouts when ingesting many files or very large files
Ingesting very large PDFs (more than 300 pages) and folders with many documents can take 30 minutes or more.
@@ -176,6 +176,9 @@ If you experience timeouts during ingestion, edit the following environment vari
* `LANGFLOW_CONNECT_TIMEOUT`
* `INGESTION_TIMEOUT`
* `UPLOAD_BATCH_SIZE`
+* `MAX_WORKERS`
+* `LANGFLOW_WORKERS`
+* `DOCLING_WORKERS`
### OCR ingestion fails (easyocr not installed) {#ocr-ingestion-fails-easyocr-not-installed}