cryptogera/bitcoin
1
0
Fork 0
mirror of https://github.com/bitcoin/bitcoin.git synced 2026-03-17 00:42:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: explain swapping in reduce-memory.md

Browse Source 
Document what swapping is and why it can severely degrade `bitcoind` performance.
This commit is contained in:
Lőrinc 2026-03-02 12:20:22 +00:00
parent 9cad97f6cd
commit a61907e5d9
No known key found for this signature in database
GPG Key ID: 669FFF0FFA477A76
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/reduce-memory.md
View File

@ -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.