From 06db0805cfb0680f2bcc9df415bdb50a91c606bb Mon Sep 17 00:00:00 2001
From: April M <36110273+aimurphy@users.noreply.github.com>
Date: Mon, 22 Dec 2025 12:42:27 -0800
Subject: [PATCH] recommended ram

---
 docs/docs/_partial-prereq-no-script.mdx | 3 +++
 docs/docs/core-components/ingestion.mdx | 9 +++++++++
 2 files changed, 12 insertions(+)

diff --git a/docs/docs/_partial-prereq-no-script.mdx b/docs/docs/_partial-prereq-no-script.mdx
index a8fd8349..c51f539d 100644
--- a/docs/docs/_partial-prereq-no-script.mdx
+++ b/docs/docs/_partial-prereq-no-script.mdx
@@ -2,5 +2,8 @@
 
 * Install [Podman](https://podman.io/docs/installation) (recommended) or [Docker](https://docs.docker.com/get-docker/).
 
+   The OpenRAG team recommends, at minimum, 8 GB of RAM for container VMs.
+   However, if you plan to upload large files regularly, more RAM is recommended.
+
 * Install [`podman-compose`](https://docs.podman.io/en/latest/markdown/podman-compose.1.html) or [Docker Compose](https://docs.docker.com/compose/install/).
 To use Docker Compose with Podman, you must alias Docker Compose commands to Podman commands.
\ No newline at end of file
diff --git a/docs/docs/core-components/ingestion.mdx b/docs/docs/core-components/ingestion.mdx
index 119a4b80..1ddb0387 100644
--- a/docs/docs/core-components/ingestion.mdx
+++ b/docs/docs/core-components/ingestion.mdx
@@ -236,11 +236,20 @@ All errors were file-specific, and they didn't stop the pipeline.
 
 ## Troubleshoot ingestion {#troubleshoot-ingestion}
 
+The following issues can occur during document ingestion.
+
+### Failed or slow ingestion
+
 If an ingestion task fails, do the following:
 
 * Make sure you are uploading supported file types.
 * Split excessively large files into smaller files before uploading.
 * Remove unusual embedded content, such as videos or animations, before uploading. Although Docling can replace some non-text content with placeholders during ingestion, some embedded content might cause errors.
+* Make sure your Podman/Docker VM has sufficient memory for the ingestion tasks.
+The minimum recommendation is 8 GB of RAM.
+If you regularly upload large files, more RAM is recommended.
+
+### Problems when referencing documents in chat
 
 If the OpenRAG **Chat** doesn't seem to use your documents correctly, [browse your knowledge base](/knowledge#browse-knowledge) to confirm that the documents are uploaded in full, and the chunks are correct.