Fast, ephemeral, embedded testing; no persistence, clustering, or server-level behavior
In-memory mode runs the Qdrant engine inside the client process with all data held in memory and discarded when the process exits. It is the fastest possible way to get a working Qdrant instance for a test: there is no server to start, no network to configure, no Docker, and no cleanup beyond letting the process end. Each test can create its own in-memory instance, or the test session can create one and give each test a unique collection. Because everything is in-process, tests run in milliseconds instead of seconds, and they can run in parallel without port conflicts. This makes in-memory mode ideal for tests of application logic that use Qdrant as a component: verifying that an embedding pipeline stores the right vectors, that a filter is constructed correctly, that a search returns the expected ordering, that a query builder produces the right request shape. For these tests, the goal is to exercise the application code against a real Qdrant API, not to test Qdrant itself.
The limitations are the other side of the same coin. In-memory mode is ephemeral: it does not persist data, so it cannot test restart behavior, snapshot creation and restore, or any scenario where data must survive a process restart. It is single-node: it does not exercise clustering, sharding, replication, consensus, or failover, so tests of distributed behavior must use a real multi-node deployment. It does not exercise the server's network stack, so it cannot test TLS, authentication, JWT RBAC, rate limiting, or the exact wire format. It may not implement every feature of the server, so tests of newer or more specialized features (e.g. certain quantization options, custom sharding, GPU indexing) may need a server. And because it runs in the same process as the test, its performance characteristics are not representative of a production server - benchmarks must be run against a real server, not in-memory mode. The practical rule is: use in-memory mode for fast tests of application logic, and use a Dockerized or real Qdrant for tests of infrastructure-level behavior.
Useful for: unit and integration tests of application code that uses Qdrant as a component.
Fast: no server startup, no network, runs in milliseconds.
Isolated: each test can create its own instance or its own collection.
Ephemeral: data is discarded on process exit; no persistence testing.
Single-node: no clustering, sharding, replication, or failover testing.
No network stack: no TLS, authentication, or JWT RBAC testing.
Feature parity: some server-only features may not be available.
Not representative for performance: benchmarks must use a real server.
The trade-off is coverage against speed and simplicity. In-memory mode gives you the fastest and simplest tests at the cost of not exercising the server's infrastructure. Docker-based or real-server tests give you full coverage at the cost of slower startup, more setup, and greater flakiness risk. A mature test suite uses both: the bulk of tests run in-memory mode, and a smaller set of infrastructure-level tests run against a real server. The common mistake is to use in-memory mode for everything and then be surprised when a production issue related to persistence, clustering, or authentication is not caught. The second mistake is to skip in-memory mode and use Docker for everything, which makes the test suite slow and discourages developers from running it locally. The third mistake is to treat in-memory mode as a performance benchmark - it is not, because the absence of network and disk I/O makes it unrepresentative. Version note: in-memory mode is provided by the qdrant-client library and its behavior and feature support have changed across client versions. Verify which features are available in in-memory mode for your client version before relying on it for tests of specific features.
Version-dependent: in-memory mode is a feature of the qdrant-client library and its coverage of server features has evolved. Newer client versions support more features in-memory; older ones support fewer. If a test depends on a specific feature, verify that in-memory mode supports it in your client version, or run the test against a real server. The exact initialization API (location=':memory:') may also differ across client versions.
0-2 years experience
2-5 years experience
5-8 years experience
8+ years experience
