From 52fed5a21340b380b5ee5ce0028dc6feb3fc531f Mon Sep 17 00:00:00 2001
From: Shaurya Vardhan Singh Chauhan <chauhanshaurya1411@gmail.com>
Date: Mon, 23 Feb 2026 01:45:19 +0530
Subject: [PATCH] Improve Quick Start documentation for system resource limits

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 6f6526c53df7c..0e93c9b7ede00 100644
--- a/README.md
+++ b/README.md
@@ -100,6 +100,29 @@ To use IoTDB, you need to have:
     # FreeBSD or Darwin
     > sudo sysctl -w kern.ipc.somaxconn=65535
     ```
+
+> ⚠️ **Important: System Resource Limits**
+>
+> IoTDB requires sufficient system resource limits to start correctly.
+> If these limits are not configured, IoTDB may fail to start or emit warnings such as
+> `"too many open files"` or `"connection reset"` in the logs.
+>
+> **Linux / macOS**
+> ```bash
+> ulimit -n 65535
+> sudo sysctl -w net.core.somaxconn=65535
+> ```
+>
+> **Docker Users**
+> When running IoTDB in Docker, these limits must be applied on the **host machine**
+> or explicitly passed to the container:
+> ```bash
+> docker run --ulimit nofile=65535:65535 ...
+> ```
+>
+> **Windows Users**
+> These commands are not applicable on Windows.
+> Please follow the Windows installation steps below and ensure sufficient system resources.
 ### Linux
 
 (This guide is based on an installation of Ubuntu 22.04.)