(couchdb) branch note-about-docker-ulimit created (now b41c527a9)

[va...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

vatamane pushed a change to branch note-about-docker-ulimit
in repository https://gitbox.apache.org/repos/asf/couchdb.git


      at b41c527a9 Document how to mitigate high memory usage in docker

This branch includes the following new commits:

     new b41c527a9 Document how to mitigate high memory usage in docker

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

(couchdb) 01/01: Document how to mitigate high memory usage in docker

[va...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

vatamane pushed a commit to branch note-about-docker-ulimit
in repository https://gitbox.apache.org/repos/asf/couchdb.git

commit b41c527a99f5933c5db002598e20d17112a838aa
Author: Nick Vatamaniuc <va...@gmail.com>
AuthorDate: Sun Jun 22 14:46:23 2025 -0400

    Document how to mitigate high memory usage in docker
    
    Thanks to @joan-morera for proving the answer in #4926
---
 src/docs/src/install/troubleshooting.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/docs/src/install/troubleshooting.rst b/src/docs/src/install/troubleshooting.rst
index fc3b0986d..f8d13eefd 100644
--- a/src/docs/src/install/troubleshooting.rst
+++ b/src/docs/src/install/troubleshooting.rst
@@ -228,6 +228,16 @@ unlimited. A detailed discussion can be found on the erlang-questions list,
 but the short answer is that you should decrease ``ulimit -n`` or lower the
 ``vm.args`` parameter ``+Q`` to something reasonable like 1024.
 
+The same issue can be manifested in some docker configurations which default
+ulimit max files to ``unlimited``. In those cases it's also recommended to set
+a lower ``nofile`` ulimit, something like 65536. In docker compose files that
+can be done as:
+
+.. code-block:: yaml
+
+    ulimits:
+      nofiles: 65535
+
 Function raised exception (Cannot encode 'undefined' value as JSON)
 -------------------------------------------------------------------
 If you see this in the CouchDB error logs, the JavaScript code you are using