Update bitcoin.conf with example for pruning #10090

coinables commented at 8:32 PM on March 26, 2017: contributor

This option is becoming more popular recently, and I propose an example to be shown in the bitcoin.conf.

fanquake added the label Docs and Output on Mar 26, 2017

laanwj commented at 7:33 AM on March 27, 2017: member

Concept ACK on adding the example.

Explicitly mentioning 3GB is not a good idea. These numbers peppered around the documentation tend to get outdated sooner than later. The size of the UTXO set is growing every day, and that can't be pruned.

in contrib/debian/examples/bitcoin.conf:135 in f8eb4b0b31 outdated

 130 | @@ -131,6 +131,10 @@
 131 |  # be validated sooner.
 132 |  #paytxfee=0.00
 133 |  
 134 | +# Prune your node to the last n blocks. 550 is the minimum. 
 135 | +# Pruning can drastically reduce the amount of disk space required to run bitcoin down to ~3GB.

laanwj commented at 7:41 AM on March 27, 2017:

You have the unit wrong, it's not in blocks but in MiB. Maybe you can borrow some description text from the help message:

  -prune=<n>
       Reduce storage requirements by enabling pruning (deleting) of old
       blocks. This allows the pruneblockchain RPC to be called to
       delete specific blocks, and enables automatic pruning of old
       blocks if a target size in MiB is provided. This mode is
       incompatible with -txindex and -rescan. Warning: Reverting this
       setting requires re-downloading the entire blockchain. (default:
       0 = disable pruning blocks, 1 = allow manual pruning via RPC,
       >550 = automatically prune block files to stay under the
       specified target size in MiB)

in contrib/debian/examples/bitcoin.conf:134 in 7400b4bbe1 outdated

 130 | @@ -131,8 +131,10 @@
 131 |  # be validated sooner.
 132 |  #paytxfee=0.00
 133 |  
 134 | -# Prune your node to the last n blocks. 550 is the minimum. 
 135 | -# Pruning can drastically reduce the amount of disk space required to run bitcoin down to ~3GB.
 136 | +# Enable pruning to reduce storage requirments by deleting old blocks.

paveljanik commented at 5:02 PM on March 27, 2017:

requirements

in contrib/debian/examples/bitcoin.conf:135 in 7400b4bbe1 outdated

 130 | @@ -131,8 +131,10 @@
 131 |  # be validated sooner.
 132 |  #paytxfee=0.00
 133 |  
 134 | -# Prune your node to the last n blocks. 550 is the minimum. 
 135 | -# Pruning can drastically reduce the amount of disk space required to run bitcoin down to ~3GB.
 136 | +# Enable pruning to reduce storage requirments by deleting old blocks. 
 137 | +# Value is in MiB. 550 is the minimum.

paveljanik commented at 5:03 PM on March 27, 2017:

550 is the minimum, but you describe entering 1...

in contrib/debian/examples/bitcoin.conf:137 in 7400b4bbe1 outdated

 130 | @@ -131,8 +131,10 @@
 131 |  # be validated sooner.
 132 |  #paytxfee=0.00
 133 |  
 134 | -# Prune your node to the last n blocks. 550 is the minimum. 
 135 | -# Pruning can drastically reduce the amount of disk space required to run bitcoin down to ~3GB.
 136 | +# Enable pruning to reduce storage requirments by deleting old blocks. 
 137 | +# Value is in MiB. 550 is the minimum. 
 138 | +# This mode is incompatible with -txindex and -rescan.
 139 | +# default = 0, 1 = allows manual pruning via RPC, >550 = target to stay under in MiB.

paveljanik commented at 5:04 PM on March 27, 2017:

=550

paveljanik changes_requested

sipa commented at 1:15 AM on March 29, 2017: member

ACK after squashing.

in contrib/debian/examples/bitcoin.conf:136 in 035400f06a outdated

 130 | @@ -131,6 +131,13 @@
 131 |  # be validated sooner.
 132 |  #paytxfee=0.00
 133 |  
 134 | +# Enable pruning to reduce storage requirments by deleting old blocks. 
 135 | +# This mode is incompatible with -txindex and -rescan.
 136 | +# 0 = default(no pruning).

paveljanik commented at 5:54 AM on March 29, 2017:

space before "(". And please squash.

in contrib/debian/examples/bitcoin.conf:134 in 035400f06a outdated

 130 | @@ -131,6 +131,13 @@
 131 |  # be validated sooner.
 132 |  #paytxfee=0.00
 133 |  
 134 | +# Enable pruning to reduce storage requirments by deleting old blocks.

paveljanik commented at 5:55 AM on March 29, 2017:

requirments -> requirements

paveljanik changes_requested

Update bitcoin.conf with example for pruning

This option is becoming more popular recently, and I propose an example to be shown in the bitcoin.conf.

pruning comments

updated and corrected pruning comments

Revised details on pruning in bitcoin.conf

Revised details on pruning in bitcoin.conf

spelling and space

spelling and space

add details on pruning in bitcoin.conf

c0651cca49

coinables force-pushed on Mar 30, 2017

fanquake commented at 1:24 AM on March 31, 2017: member

utACK c0651cc

MarcoFalke merged this on Mar 31, 2017

MarcoFalke closed this on Mar 31, 2017

MarcoFalke referenced this in commit 8e4f7e7241 on Mar 31, 2017

laanwj commented at 10:14 AM on March 31, 2017: member

I think we should move this file somewhere else - doc/examples maybe? After all it is a general example of a bitcoin.conf and there is nothing debian-specific to it.

PastaPastaPasta referenced this in commit 8bac5ef888 on Mar 15, 2019

PastaPastaPasta referenced this in commit 6e47031cd1 on May 20, 2019

PastaPastaPasta referenced this in commit 819a80e21a on May 20, 2019

PastaPastaPasta referenced this in commit 96d864ecda on May 21, 2019

PastaPastaPasta referenced this in commit 44dffdde0e on May 22, 2019

PastaPastaPasta referenced this in commit 84b8a7b574 on May 22, 2019

PastaPastaPasta referenced this in commit c0f08f4b31 on May 22, 2019

PastaPastaPasta referenced this in commit 67802571a8 on May 22, 2019

PastaPastaPasta referenced this in commit c8a565d6e6 on May 23, 2019

barrystyle referenced this in commit de3acc9dfb on Jan 22, 2020

MarcoFalke locked this on Sep 8, 2021