From b209731ff326b050e4491ab571bce8dff01bfc7c Mon Sep 17 00:00:00 2001
From: Steve Chavez <stevechavezast@gmail.com>
Date: Wed, 9 Feb 2022 14:17:22 -0500
Subject: [PATCH] Add admin section on file descriptors (#504)

---
 docs/admin.rst | 12 ++++++++++++
 postgrest.dict |  1 +
 2 files changed, 13 insertions(+)

diff --git a/docs/admin.rst b/docs/admin.rst
index c319c29c4..d487062ed 100644
--- a/docs/admin.rst
+++ b/docs/admin.rst
@@ -256,6 +256,7 @@ Schema Reloading
 
 Changing the schema while the server is running can lead to errors due to a stale schema cache. To learn how to refresh the cache see :ref:`schema_reloading`.
 
+
 Daemonizing
 ===========
 
@@ -295,6 +296,17 @@ After that, you can enable the service at boot time and start it with:
   ## For reloading the service
   ## systemctl restart postgrest
 
+File Descriptors
+----------------
+
+File descriptors are kernel resources that are used by HTTP connections (among others). File descriptors are limited per process. The kernel default limit is 1024, which is increased in some Linux distributions.
+When under heavy traffic, PostgREST can reach this limit and start showing ``No file descriptors available`` errors. To clear these errors, you can increase the process' file descriptor limit.
+
+.. code-block:: ini
+
+  [Service]
+  LimitNOFILE=10000
+
 Alternate URL Structure
 =======================
 
diff --git a/postgrest.dict b/postgrest.dict
index 16a91dd58..60c7055c1 100644
--- a/postgrest.dict
+++ b/postgrest.dict
@@ -51,6 +51,7 @@ Haskell
 Heroku
 HMAC
 Homebrew
+HTTP
 HTTPS
 HV
 Ibarluzea