Configurables

The search module uses the Valkey configuration mechanism. Thus each of the named configuration below can be set on the module load command OR via the CONFIG SET command.

Name	Type	Default Value	Description
search.query-string-bytes	Number		Controls the length of the query string for FT.SEARCH command
search.hnsw-block-size	Number		HNSW resize configuration parameter for vector index block allocation
search.reader-threads	Number		Controls the reader thread pool size; dynamically resizes pool on modification
search.writer-threads	Number		Controls the writer thread pool size; dynamically resizes pool on modification
search.utility-threads	Number		Controls the utility thread pool size; dynamically resizes pool on modification
search.max-worker-suspension-secs	Number		Max time in seconds that worker thread pool is suspended after fork started
search.use-coordinator	Boolean		Controls whether this instance uses coordinator; can only be set at startup
search.skip-rdb-load	Boolean		Skip loading vector index data from RDB file
search.skip-corrupted-internal-update-entries	Boolean		Skip corrupted AOF entries during internal updates
search.log-level	Enum		Controls module log level verbosity
search.enable-partial-results	Boolean	yes	Default option for delivering partial results when timeout occurs (uses SOMESHARDS if not explicitly provided)
search.enable-consistent-results	Boolean	no	Default option for delivering consistent results when timeout occurs (uses CONSISTENT if not explicitly provided)
search.search-result-background-cleanup	Boolean		Enable search result cleanup on background thread
search.high-priority-weight	Number		Weight for high priority tasks in thread pools; low priority = 100 - this value
search.ft-info-timeout-ms	Number		Timeout in milliseconds for FT.INFO fanout command
search.ft-info-rpc-timeout-ms	Number		RPC timeout in milliseconds for FT.INFO fanout command
search.local-fanout-queue-wait-threshold	Number		Queue wait threshold in milliseconds for preferring local node in fanout operations
search.thread-pool-wait-time-samples	Number		Sample queue size for thread pool wait time tracking
search.max-term-expansions	Number		Maximum number of words to search in text operations (prefix, suffix, fuzzy) to limit memory usage
search.tag-min-prefix-length	Number		Minimum number of characters required before trailing * in TAG wildcard queries (length excludes *)
search.search-result-buffer-multiplier	String		Multiplier for search result buffer size allocation
search.drain-mutation-queue-on-save	Boolean		Drain the mutation queue before RDB save
search.query-string-depth	Number		Controls the depth of the query string parsing from the FT.SEARCH cmd
search.query-string-terms-count	Number		Controls the size of the query string parsing from the FT.SEARCH cmd (number of nodes in predicate tree)
search.fuzzy-max-distance	Number		Controls the maximum allowed edit distance for fuzzy search queries
search.max-vector-knn	Number		Controls the max KNN parameter for vector search
search.max-nonvector-search-results-fetched	Number	100000	Maximum number of keys a non-vector query collects before fetching their contents; a query that matches more keys returns only this many. For queries with a VECTOR_RANGE matcher, see Vector Range Match
search.proximity-inorder-compat-mode	Boolean		Controls proximity iterator's inorder/overlap violation check logic (compatibility mode)
search.max-prefixes	Number		Controls the max number of prefixes per index
search.max-tag-field-length	Number		Controls the max length of a tag field
search.max-numeric-field-length	Number		Controls the max length of a numeric field
search.max-vector-attributes	Number		Controls the max number of attributes per index
search.max-vector-dimensions	Number		Controls the max dimensions for vector indices
search.max-vector-m	Number		Controls the max M parameter for HNSW algorithm
search.max-vector-ef-construction	Number		Controls the max EF construction parameter for HNSW algorithm
search.max-vector-ef-runtime	Number		Controls the max EF runtime parameter for HNSW algorithm
search.default-timeout-ms	Number		Controls the default timeout in milliseconds for FT.SEARCH
search.max-timeout-ms	Number		Controls the maximum allowed TIMEOUT value, in milliseconds, for FT.SEARCH and FT.AGGREGATE
search.max-search-result-record-size	Number		Controls the max content size for a record in the search response
search.max-search-result-fields-count	Number		Controls the max number of fields in the content of the search response
search.backfill-batch-size	Number		Controls the batch size for backfilling indexes
search.cursor-max-count	Number	100000	Maximum COUNT accepted by WITHCURSOR and FT.CURSOR READ
search.cursor-max-idle-ms	Number	INT64_MAX	Maximum MAXIDLE (milliseconds) accepted by WITHCURSOR
search.coordinator-query-timeout-secs	Number		Controls the gRPC deadline timeout (in seconds) for distributed coordinator query operations.
search.max-indexes	Number		Controls the maximum number of search indexes that can be created in the system
search.cluster-map-expiration-ms	Number		Controls how long (in milliseconds) the coordinator caches the cluster topology map before refreshing it from the Valkey cluster.