summaryrefslogtreecommitdiff
path: root/docs/configuration/advanced.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/configuration/advanced.md')
-rw-r--r--docs/configuration/advanced.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/configuration/advanced.md b/docs/configuration/advanced.md
index 48b1b569d..f4b8c5ffa 100644
--- a/docs/configuration/advanced.md
+++ b/docs/configuration/advanced.md
@@ -35,4 +35,21 @@ These are set to sensible defaults, so most server admins won't need to touch th
# Options: ["lax", "strict"]
# Default: "lax"
advanced-cookies-samesite: "lax"
+
+# Int. Amount of requests to permit from a single IP address within a span of 5 minutes.
+# If this amount is exceeded, a 429 HTTP error code will be returned.
+# See https://docs.gotosocial.org/en/latest/api/swagger/#rate-limit.
+#
+# If you find yourself adjusting this limit because it's regularly being exceeded,
+# you should first verify that your settings for `trusted-proxies` (above) are correct.
+# In many cases, when the rate limit is exceeded it is because your instance sees all
+# incoming requests as coming from the *same IP address* (you can verify this by looking
+# at the client IPs in your instance logs). If this is the case, try adding that IP
+# address to your `trusted-proxies` *BEFORE* you go adjusting this rate limit setting!
+#
+# If you set this to 0 or less, rate limiting will be disabled entirely.
+#
+# Examples: [1000, 500, 0]
+# Default: 1000
+advanced-rate-limit-requests: 1000
```