From 7d8fa428601c12699ee03d148e48254a2cd18290 Mon Sep 17 00:00:00 2001 From: Quentin de Quelen Date: Tue, 18 Aug 2026 16:20:05 +0200 Subject: [PATCH] Document MEILI_EXPERIMENTAL_TASK_QUEUE_MAX_READERS from v1.53.1 v1.53.1 added an environment variable controlling the maximum number of simultaneous read transactions on the task queue database. The v1.53 release update covered v1.53.0 only, since it was opened three days before v1.53.1 shipped. - Fold the option into the existing v1.53 changelog entry, following the v1.43.1 precedent of documenting patches inside the minor entry - Add the option to the configuration reference, grouped with the other task queue options - Add a row to the experimental features table --- changelog/changelog.mdx | 8 ++++++++ resources/help/experimental_features_overview.mdx | 1 + resources/self_hosting/configuration/reference.mdx | 8 ++++++++ 3 files changed, 17 insertions(+) diff --git a/changelog/changelog.mdx b/changelog/changelog.mdx index 7f84c0565f..2d4ec44c47 100644 --- a/changelog/changelog.mdx +++ b/changelog/changelog.mdx @@ -23,6 +23,14 @@ These metrics help you monitor storage usage per index and across your whole Mei Foreign filters now support sharding. Document retrieval during filter evaluation is performed through the network layer, allowing foreign filters to work correctly in sharded setups. In addition, the maximum number of documents a foreign filter can retrieve has been increased from 100 to 1000. +**Configurable task queue readers (v1.53.1)** + +A new environment variable controls the maximum number of simultaneous read transactions on the task queue database. It defaults to `1024` and can only be set through the environment: + +```sh +MEILI_EXPERIMENTAL_TASK_QUEUE_MAX_READERS=100 +``` + [Find more information on GitHub](https://github.com/meilisearch/meilisearch/releases/tag/v1.53.0) diff --git a/resources/help/experimental_features_overview.mdx b/resources/help/experimental_features_overview.mdx index 2a8d1f6d96..ea96ff631d 100644 --- a/resources/help/experimental_features_overview.mdx +++ b/resources/help/experimental_features_overview.mdx @@ -73,3 +73,4 @@ The **logs** and **metrics** experimental features are not available on Meilisea | [Task queue compaction](/reference/api/async-task-management/compact-task-queue) | Compact the task queue database to reclaim space for new tasks | API route | | [Disable documents fetch queue ](/reference/api/async-task-management/get-tasks-document-payload) | Disable the documents fetch queue, which forces document fetch routes to wait in the search queue when no thread is available | API route | | [Render template](/reference/api/template/render-template) | Render document templates and fragments against any input to test embedder configuration | API route | +| [Task queue maximum readers](/resources/self_hosting/configuration/reference#task-queue-maximum-readers) | Configure the maximum number of simultaneous read transactions on the task queue | Environment variable | diff --git a/resources/self_hosting/configuration/reference.mdx b/resources/self_hosting/configuration/reference.mdx index 97b5552f0e..49a329da93 100644 --- a/resources/self_hosting/configuration/reference.mdx +++ b/resources/self_hosting/configuration/reference.mdx @@ -387,6 +387,14 @@ Limit the number of tasks Meilisearch performs in a single batch. May improve st Sets a maximum payload size for batches in bytes. Smaller batches are less efficient, but consume less RAM and reduce immediate latency. +### Task queue maximum readers + +**Environment variable**: `MEILI_EXPERIMENTAL_TASK_QUEUE_MAX_READERS`
+**Default value**: `1024`
+**Expected value**: a positive integer + +Sets the maximum number of simultaneous read transactions on the task queue database. Raise it if your instance serves a high number of concurrent reads of the task queue. Meilisearch fails to start if the value is not a valid positive integer. This configuration is only available via environment variable; no CLI flag is available. + ### Disable new indexer