From 3e19fe6c54cdcf4ff877647bba6b1e2b954788ab Mon Sep 17 00:00:00 2001 From: Oleksii Syniakov <1282756+osyniakov@users.noreply.github.com> Date: Thu, 12 Mar 2026 11:55:54 +0100 Subject: [PATCH] Improve cluster sizing doc on control plane/metastore/janitor. Closes #5872 --- docs/deployment/cluster-sizing.md | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/docs/deployment/cluster-sizing.md b/docs/deployment/cluster-sizing.md index 59e1aa6566c..d69b5235310 100644 --- a/docs/deployment/cluster-sizing.md +++ b/docs/deployment/cluster-sizing.md @@ -74,17 +74,22 @@ Searcher nodes based on: ### Other services The Control Plane, Metastore and, Janitor are lightweight components. -Each of these services requires 1 replica. -The Control Plane needs a single core and 2GB of RAM. It doesn't require any disk. - -The Metastore also requires a single core and 2GB of RAM. For clusters handling -hundreds of indexes, you may increase the size to 2 cores and 4GB of RAM. It -doesn't write to disk. - -In general, the Janitor requires 1 core and 2GB of RAM and doesn't use the disk. -If you use the [delete API](https://quickwit.io/docs/overview/concepts/deletes), -the Janitor should be dimensioned like an indexer. +- **Control Plane**: A cluster must have only one Control Plane. It needs a + single core and 2GB of RAM. It doesn't require any disk. + +- **Metastore**: A cluster must have exactly one Metastore when using the + [file-backed metastore](../configuration/metastore-config.md#file-backed-metastore). + When using the [PostgreSQL metastore](#postgres-metastore-backend), you can + run one or several Metastore pods for high availability (HA). The Metastore + requires a single core and 2GB of RAM. For clusters handling hundreds of + indexes, you may increase the size to 2 cores and 4GB of RAM. It doesn't + write to disk (when using PostgreSQL, the database handles persistence). + +- **Janitor**: A cluster must have only one Janitor. In general, it requires 1 + core and 2GB of RAM and doesn't use the disk. If you use the [delete + API](https://quickwit.io/docs/overview/concepts/deletes), the Janitor should + be dimensioned like an indexer. ### Single node deployments