doc: Document initial setup storage cost and node startup in macOS build guide #35876

pull Alwoch wants to merge 2 commits into bitcoin:master from Alwoch:doc-osx-blockchain-size changing 1 files +17 −2
  1. Alwoch commented at 8:37 AM on August 4, 2026: none

    The "Running Bitcoin Core" section tells the reader how long the initial blockchain sync takes, but not what it costs in disk space or bandwidth. Following this guide end to end, one can start an initial block download without ever being told it will consume several hundred gigabytes of storage. bitcoind does warn about this at startup, but init.cpp only emits it when CheckDiskSpace fails so a user with a large drive is never told, and the warning arrives after the build and configuration steps are already done.

    170e37353d6008d1675a6e063ab72e482f1b64f3 adds the storage and bandwidth cost to the existing sentence. It also shows the signet and regtest alternatives, following the pattern used elsewhere in this guide of pairing a cost with a way to opt out of it (-DENABLE_WALLET=OFF, -DWITH_QRENCODE=OFF, and so on).The exact figure is left as "several hundred gigabytes" rather than the current value. m_assumed_blockchain_size is already regularly updated per release in chainparams.cpp; a second copy here would have no update process attached to it.

    0a85eab2228d6dffb8a8b44e09d206fb2fc26230 moves the command that starts the node out of "Other commands:" and into the running flow. A section titled "Running Bitcoin Core" previously never showed how to run it. The start command sat at the bottom of the page under a heading implying it was secondary.

    Tested by running bitcoind -signet and bitcoind -regtest as documented.

  2. doc: Document initial sync cost and test network alternatives 170e37353d
  3. doc: Move node start commands into Running Bitcoin Core 0a85eab222
  4. DrahtBot added the label Docs on Aug 4, 2026
  5. DrahtBot commented at 8:37 AM on August 4, 2026: contributor

    <!--e57a25ab6845829454e8d69fc972939a-->

    The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

    <!--006a51241073e994b41acfe9ec718e94-->

    Code Coverage & Benchmarks

    For details see: https://corecheck.dev/bitcoin/bitcoin/pulls/35876.

    <!--021abf342d371248e50ceaed478a90ca-->

    Reviews

    See the guideline and AI policy for information on the review process. A summary of reviews will appear here.

    <!--5faf32d7da4f0f540f40219e4f7537a3-->

  6. sedited commented at 8:47 AM on August 4, 2026: contributor

    Thank you for the contribution, but this is fine as is, because the space requirement and synchronization process is already covered in doc/README. The test networks also don't deserve a notice in a document that is otherwise build-only. Closing this again.

  7. sedited closed this on Aug 4, 2026

Labels

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-08-23 22:51 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me