{"record":{"id":"fc04693fac561cdb","repo":"quickwit-oss/quickwit","slug":"max-queue-disk-usage-must-be-at-least-256-mib-got","errorCode":null,"errorMessage":"max_queue_disk_usage must be at least 256 MiB, got `{}`","messagePattern":"max_queue_disk_usage must be at least 256 MiB, got `(.+?)`","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"quickwit/quickwit-config/src/node_config/mod.rs","lineNumber":807,"sourceCode":"    pub fn decommission_timeout(&self) -> Duration {\n        quickwit_common::get_duration_from_env(\n            \"QW_INGEST_DECOMMISSION_TIMEOUT\",\n            Duration::from(self.decommission_timeout.clone()),\n        )\n    }\n\n    pub fn grpc_compression_encoding(&self) -> Option<CompressionEncoding> {\n        self.grpc_compression_algorithm\n            .as_ref()\n            .map(|algorithm| match algorithm {\n                CompressionAlgorithm::Gzip => CompressionEncoding::Gzip,\n                CompressionAlgorithm::Zstd => CompressionEncoding::Zstd,\n            })\n    }\n\n    fn validate(&self) -> anyhow::Result<()> {\n        self.warn_if_replication_factor_is_set();\n        ensure!(\n            self.max_queue_disk_usage > ByteSize::mib(256),\n            \"max_queue_disk_usage must be at least 256 MiB, got `{}`\",\n            self.max_queue_disk_usage.display().si()\n        );\n        ensure!(\n            self.max_queue_disk_usage >= self.max_queue_memory_usage,\n            \"max_queue_disk_usage ({}) must be at least max_queue_memory_usage ({})\",\n            self.max_queue_disk_usage.display().si(),\n            self.max_queue_memory_usage.display().si()\n        );\n        info!(\n            \"ingestion shard throughput limit: {}\",\n            self.shard_throughput_limit.display().si()\n        );\n        ensure!(\n            self.shard_throughput_limit >= ByteSize::mib(1)\n                && self.shard_throughput_limit <= ByteSize::mib(20),\n            \"shard_throughput_limit ({}) must be within 1mb and 20mb\",","sourceCodeStart":789,"sourceCodeEnd":825,"githubUrl":"https://github.com/quickwit-oss/quickwit/blob/a39730c5cdcd1a4fe798403737ae293999ea21f8/quickwit/quickwit-config/src/node_config/mod.rs#L789-L825","documentation":"The ingest (shard queue) config validation enforces a minimum queue disk usage of 256 MiB. Values at or below `ByteSize::mib(256)` are rejected because extremely small on-disk queues cause pathological behavior (constant rollofs) — note the check is strictly `>` 256 MiB, so exactly 256 MiB also fails.","triggerScenarios":"Setting `max_queue_disk_usage` in the node config to a value like 128mib, 100mb, or exactly 256mib, then validating the node config (startup).","commonSituations":"Trying to minimize disk footprint on small/test nodes; copy-pasting a low value from a benchmark config; confusing MiB with MB and setting a smaller effective size.","solutions":["Raise `max_queue_disk_usage` above 256 MiB (e.g. `512mib`)","Remove the explicit setting to use the default value","Check the unit suffix — `256mib` fails; use `257mib` or larger"],"exampleFix":"// before\nmax_queue_disk_usage: 256mib\n// after\nmax_queue_disk_usage: 512mib","handlingStrategy":"validation","validationCode":"fn ensure_queue_disk_usage(v: ByteSize) -> anyhow::Result<()> {\n    if v <= ByteSize::mib(256) {\n        anyhow::bail!(\"max_queue_disk_usage must exceed 256 MiB, got {}\", v.display().si());\n    }\n    Ok(())\n}","typeGuard":null,"tryCatchPattern":"if let Err(e) = ingest_config.validate() {\n    if e.to_string().contains(\"max_queue_disk_usage must be at least 256 MiB\") {\n        eprintln!(\"Raise max_queue_disk_usage above 256 MiB (strictly greater).\");\n    }\n}","preventionTips":["Use at least 512 MiB for max_queue_disk_usage on small nodes","Remember the check is strict: 256mib exactly is rejected","Prefer defaults unless you have a specific sizing requirement"],"tags":["config","ingest","validation"],"backgroundTag":"value-out-of-range","analyzedSha":"a39730c5cdcd1a4fe798403737ae293999ea21f8","analyzedAt":"2026-09-08T13:19:37.784Z","contentChangedAt":"2026-09-08T13:19:37.784Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}