From 7c4aae5b9f123328725c3f5d9f1e3aab46397878 Mon Sep 17 00:00:00 2001 From: Michael M Slusarz Date: Fri, 8 May 2026 00:34:17 -0600 Subject: [PATCH] settings: Document fts_flatcurve_optimize_density_pct --- data/settings.js | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/data/settings.js b/data/settings.js index 90589b14b..4c0a01286 100644 --- a/data/settings.js +++ b/data/settings.js @@ -2505,6 +2505,24 @@ write DB. Most people should not change this setting. Set to \`0\` to disable rotation.` }, + fts_flatcurve_optimize_density_pct: { + default: 25, + values: setting_types.UINT, + plugin: 'fts-flatcurve', + advanced: true, + seealso: [ 'fts_flatcurve_rotate_count' ], + text: ` +When an index shard's message count falls below this percentage of +rotate_count, the mailbox is scheduled for deferred optimization. +This helps prevent accumulation of sparse shards that degrade +mailbox open performance. + +Set to \`0\` to disable density-based optimization. + +This optimization requires [[setting,fts_flatcurve_rotate_count]] to be +enabled.` + }, + fts_flatcurve_substring_search: { default: 'no', values: setting_types.BOOLEAN,