Introducing Dragonfly Cloud! Learn More

Question: How do you configure caching in MongoDB?


In MongoDB, caching is handled by the WiredTiger storage engine's internal mechanisms. The cache is used to store recently read data and indexes, making subsequent reads faster. The size of the WiredTiger cache is crucial for performance and can be configured to optimize your MongoDB instance. Below are some steps and considerations for configuring MongoDB's cache.

Understanding Default Cache Configuration

By default, WiredTiger allocates approximately half of the available system memory to the cache but not more than 50% of RAM or less than 256MB. This default configuration works well for many deployments, but specific workloads or deployments may require tuning.

Adjusting Cache Size

To adjust the cache size, you need to modify the storage.wiredTiger.engineConfig.cacheSizeGB setting in your MongoDB configuration file (typically named mongod.conf) or pass it as a command-line parameter when starting mongod.

Configuration File Example

storage: wiredTiger: engineConfig: cacheSizeGB: <sizeInGB>

Replace <sizeInGB> with the desired cache size in gigabytes. This setting will instruct MongoDB to use a fixed cache size instead of the auto-configured value.

Command Line Example

mongod --wiredTigerCacheSizeGB <sizeInGB>

Considerations for Cache Configuration

  • Workload Characteristics: A read-heavy workload might benefit from a larger cache, while a write-heavy workload might not.
  • System Memory: Ensure that there's enough RAM for both MongoDB's cache and the operating system's own needs. Allocating too much memory to MongoDB can lead to swapping, which severely degrades performance.
  • Monitoring Performance: Use MongoDB's monitoring capabilities to observe the effects of any cache size adjustments. Look at metrics like page faults, cache hit/miss ratios, and overall system performance.


Properly configuring MongoDB's cache can significantly impact database performance. By understanding your workload and monitoring system performance, you can make informed decisions on cache sizing. Always test changes in a controlled environment before applying them to your production systems.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book

Start building today 

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.