diff --git a/doc/reduce-memory.md b/doc/reduce-memory.md index cac5dc982d1..e3ab3bad67b 100644 --- a/doc/reduce-memory.md +++ b/doc/reduce-memory.md @@ -2,6 +2,15 @@ There are a few parameters that can be dialed down to reduce the memory usage of `bitcoind`. This can be useful on embedded systems or small VPSes. +## Swapping + +When the operating system is under memory pressure, it may swap memory pages from RAM to disk. +If this becomes continuous ("thrashing"), `bitcoind` can slow to a crawl, especially during initial sync or reindex. + +If you see sustained swap I/O while `bitcoind` runs, restart with a lower `-dbcache`. +If needed, also reduce `-maxmempool`, `-maxconnections`, or use `-blocksonly`. +Bitcoin Core may warn at startup when `-dbcache` looks too large for the detected system memory. + ## In-memory caches The size of some in-memory caches can be reduced. As caches trade off memory usage for performance, reducing these will usually have a negative effect on performance.