From c158558ad88f98d7d2f183164bfe506191f21d4a Mon Sep 17 00:00:00 2001
From: Scott Blake <945258+MScottBlake@users.noreply.github.com>
Date: Thu, 28 May 2026 12:43:13 -0400
Subject: [PATCH] Update `mysql_max_open_conns` documentation (#37289)

Clarified the definition and usage of `mysql_max_open_conns`.

Co-authored-by: Brock Walters <153771548+nonpunctual@users.noreply.github.com>
---
 docs/Configuration/fleet-server-configuration.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/Configuration/fleet-server-configuration.md b/docs/Configuration/fleet-server-configuration.md
index 9c632edac6..892f27fe77 100644
--- a/docs/Configuration/fleet-server-configuration.md
+++ b/docs/Configuration/fleet-server-configuration.md
@@ -145,7 +145,9 @@ This is the server name or IP address used by the client certificate.
 
 ### mysql_max_open_conns
 
-The maximum open connections to the database.
+The maximum open connections from each Fleet server to the database. This value should be less than the database's maximum connection limit.
+
+If your database has 100 connections available and you have up to 3 Fleet servers running, this value should be 30 to avoid opening more connections than the database can handle and still leave a small buffer.
 
 - Default value: 50
 - Environment variable: `FLEET_MYSQL_MAX_OPEN_CONNS`