Skip to main content
Version: 0.4.0

Deployment modes

Quickwit is composed of 3 services:

  • the indexer service: it starts the indexing pipelines and serves the Ingest API;
  • the searcher service: it serves the Search and Aggregation API;
  • the UI service: it serves the static assets required by the UI React app.

Quickwit is compiled as a single binary or Docker image, and you can choose to start the indexer or the searcher or both of them. As for the UI service, it is always launched. You can deploy Quickwit on a single node or multiple nodes. However, please note that some deployment configurations are still rough around the edges, so read the current limitations carefully.


This is the simplest way to get started with Quickwit. First, launch all the services with the quickwit run command, and then you're ready to ingest and search data.

Multi nodes: single indexer, multiple searchers

One Quickwit node running on a decent instance can ingest data at speeds up to 40 MB/sec from Kafka. A deployment with one indexer is thus a good start. However, you may need several searchers for handling large datasets or serving many resource-intensive queries such as aggregation queries.

As soon as you are running at least 2 nodes, there are several restrictions:

  • you have to use a distributed data store such as Amazon S3 or MinIO for storing your index; a local file system storage will not work;
  • if you use the Ingest API, you must send your queries directly to the indexer. When sent to a searcher, you will get a 404 response. Note that when search queries are addressed to an indexer, it acts as a root searcher node and dispatches leaf requests to searchers;

Multiple indexers, multiple searchers

Coming soon :)

General limitations


We're actively working on removing those limitations. Most of them should be resolved in the next releases.

CLI limitations

While running one or several nodes, we strongly discourage you to use the CLI to manage indexes (add/delete operations) as we do not notify the running services of the modifications.

For example, if you create an index with the CLI while an indexer is running, it will not be notified of the creation event and will not accept ingest requests for this new index. Therefore, you will need to restart the indexer to be able to ingest documents for this index. A searcher will behave similarly on index creation but not on index deletion. For example, a file-backed metastore server will not be aware of the index deletion and will continue trying to serve search queries and return 500 errors.

Generally speaking:

  • when you create/delete indexes, you should restart your indexer;
  • when you delete indexes, you should restart your searchers if you use a file-backed metastore.

File-backed metastore limitations

The file-backed metastore is mainly useful for testing purposes. Though it may be convenient for some specific use cases, we strongly encourage you to use a PostgreSQL metastore in production. The main limitations of the file-backed metastore are:

  • it does not support concurrent writes;
  • it caches metastore data and polls files regularly to update its cache. Thus it has a delayed view on the metastore.