From 54422ffcbf5eaf54ccb8e90d03877505ed138d5b Mon Sep 17 00:00:00 2001 From: Will Binns Date: Sun, 1 Jan 2017 17:41:06 -0600 Subject: [PATCH 1/6] full-node: Add info on pruning to reduce storage --- en/full-node.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/en/full-node.md b/en/full-node.md index 1ea3f709..5fb0f2e2 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -1287,6 +1287,25 @@ If you have any questions about configuring Bitcoin Core, please stop by one of our [forums](/en/bitcoin-core/help#forums) or [live chatrooms](/en/bitcoin-core/help#live). +### Reduce Storage + +It is possible to configure your node to to run in pruned mode in order to +reduce storage requirements. This can reduce the disk usage from over 100GB to +around 2GB. + +Running a node in pruned mode disables the RPCs `importwallet`, `importaddress`, +and `importprivkey`. + +To enable block pruning set `prune=` on the command line or in `bitcoin.conf`, +where `N` is the number of MiB to allot for raw block & undo data. + +A value of `0` disables pruning. The minimal value above `0` is `550`. Your +wallet is as secure with high values as it is with low ones. Higher values +merely ensure that your node will not shut down upon blockchain reorganizations +of more than 2 days - which are unlikely to happen in practice. In future +releases, a higher value may also help the network as a whole because stored +blocks could be served to other nodes. + ### Reduce Traffic Some node operators need to deal with bandwith caps imposed by their ISPs. From 941d4e5d5e36840ae612057911ffaab277f9a3be Mon Sep 17 00:00:00 2001 From: Will Binns Date: Sun, 1 Jan 2017 22:07:49 -0600 Subject: [PATCH 2/6] full-node: Add note about txindex and rescan --- en/full-node.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/en/full-node.md b/en/full-node.md index 5fb0f2e2..af471b60 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -1293,7 +1293,8 @@ It is possible to configure your node to to run in pruned mode in order to reduce storage requirements. This can reduce the disk usage from over 100GB to around 2GB. -Running a node in pruned mode disables the RPCs `importwallet`, `importaddress`, +Running a node in pruned mode is incompatible with `-txindex` +and `-rescan` and disables the RPCs `importwallet`, `importaddress`, and `importprivkey`. To enable block pruning set `prune=` on the command line or in `bitcoin.conf`, From d5f24bee1fcdbfd9bbcdf795c335f705957b3bb8 Mon Sep 17 00:00:00 2001 From: Will Binns Date: Mon, 2 Jan 2017 23:49:41 -0600 Subject: [PATCH 3/6] full-node: Drop brackets around 'N' for readability --- en/full-node.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/full-node.md b/en/full-node.md index af471b60..c1be4667 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -1297,7 +1297,7 @@ Running a node in pruned mode is incompatible with `-txindex` and `-rescan` and disables the RPCs `importwallet`, `importaddress`, and `importprivkey`. -To enable block pruning set `prune=` on the command line or in `bitcoin.conf`, +To enable block pruning set `prune=N` on the command line or in `bitcoin.conf`, where `N` is the number of MiB to allot for raw block & undo data. A value of `0` disables pruning. The minimal value above `0` is `550`. Your From 46a02391f45c6dbfb0881f37b5e1ce9c7a130b6d Mon Sep 17 00:00:00 2001 From: Will Binns Date: Mon, 2 Jan 2017 23:51:26 -0600 Subject: [PATCH 4/6] full-node: Drop ampersand, use 'and' --- en/full-node.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/full-node.md b/en/full-node.md index c1be4667..45c34973 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -1298,7 +1298,7 @@ and `-rescan` and disables the RPCs `importwallet`, `importaddress`, and `importprivkey`. To enable block pruning set `prune=N` on the command line or in `bitcoin.conf`, -where `N` is the number of MiB to allot for raw block & undo data. +where `N` is the number of MiB to allot for raw block and undo data. A value of `0` disables pruning. The minimal value above `0` is `550`. Your wallet is as secure with high values as it is with low ones. Higher values From d15f4752f0fac61446f3c2cef2d0f1542eff386d Mon Sep 17 00:00:00 2001 From: Will Binns Date: Tue, 3 Jan 2017 00:05:01 -0600 Subject: [PATCH 5/6] full-node: Revise disabled RPCs This removes two of the RPCs because they were later reenabled in Bitcoin Core when in pruning mode. --- en/full-node.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/en/full-node.md b/en/full-node.md index 45c34973..74eab711 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -1293,9 +1293,8 @@ It is possible to configure your node to to run in pruned mode in order to reduce storage requirements. This can reduce the disk usage from over 100GB to around 2GB. -Running a node in pruned mode is incompatible with `-txindex` -and `-rescan` and disables the RPCs `importwallet`, `importaddress`, -and `importprivkey`. +Running a node in pruned mode is incompatible with `-txindex` and `-rescan`. It +also disables the RPC `importwallet`. To enable block pruning set `prune=N` on the command line or in `bitcoin.conf`, where `N` is the number of MiB to allot for raw block and undo data. From 8a0762be4f9c5406c51025fbdd56e26a90294ae8 Mon Sep 17 00:00:00 2001 From: Will Binns Date: Tue, 3 Jan 2017 00:08:14 -0600 Subject: [PATCH 6/6] full-node: Add importprunedfunds/removeprunedfunds --- en/full-node.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/en/full-node.md b/en/full-node.md index 74eab711..0702447b 100644 --- a/en/full-node.md +++ b/en/full-node.md @@ -1294,7 +1294,8 @@ reduce storage requirements. This can reduce the disk usage from over 100GB to around 2GB. Running a node in pruned mode is incompatible with `-txindex` and `-rescan`. It -also disables the RPC `importwallet`. +also disables the RPC `importwallet`. Two RPCs that are available and +potentially helpful, however, are `importprunedfunds` and `removeprunedfunds`. To enable block pruning set `prune=N` on the command line or in `bitcoin.conf`, where `N` is the number of MiB to allot for raw block and undo data.