You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
bitcoin/doc
laanwj ba11eb354b
Merge bitcoin/bitcoin#23542: net: open p2p connections to nodes that listen on non-default ports
3 years ago
..
man scripted-diff: Fix typo in stub manual pages 4 years ago
policy [doc] package deduplication 3 years ago
release-notes doc: Add historical release notes for 22.0 3 years ago
.gitignore
Doxyfile.in Generate doxygen documentation for test sources 4 years ago
JSON-RPC-interface.md Update 'Secure string handling' 4 years ago
README.md net: open p2p connections to nodes that listen on non-default ports 3 years ago
README_doxygen.md
README_windows.txt
REST-interface.md transaction decoding infer output descriptors 3 years ago
assets-attribution.md
assumeutxo.md doc: add assumeutxo notes 3 years ago
benchmarking.md doc: update doc/benchmarking.md 3 years ago
bips.md doc: Mention missing BIP157 in bips.md 3 years ago
bitcoin-conf.md doc: added info to bitcoin.conf doc 3 years ago
bitcoin_logo_doxygen.png
build-android.md build, qt: Use Android NDK r23 LTS 3 years ago
build-freebsd.md docs: improve make with parallel jobs description. 4 years ago
build-netbsd.md docs: improve make with parallel jobs description. 4 years ago
build-openbsd.md doc: remove CC_FOR_BUILD from OpenBSD build doc 3 years ago
build-osx.md build: use a static .tiff for macOS .dmg over generating 3 years ago
build-unix.md build: use header-only Boost unit test 3 years ago
build-windows.md doc: Install only "-posix" MinGW compiler when possible 3 years ago
dependencies.md build: upgrade depends Boost to 1.77.0 3 years ago
descriptors.md docs: Move explanation of hardened key syntax closer to KEY section 3 years ago
developer-notes.md Replace "can not" with "cannot" in docs, user messages, and tests 3 years ago
dnsseed-policy.md
external-signer.md Move external signer out of wallet module 4 years ago
files.md Ignore banlist.dat 3 years ago
fuzzing.md fuzz: parse the command line arguments in fuzz tests 3 years ago
guix.md docs: Point to contrib/guix/README.md in doc/guix.md 4 years ago
i2p.md net: respect -onlynet= when making outbound connections 3 years ago
init.md doc: Replace tabs for spaces 4 years ago
managing-wallets.md Update doc to match new default wallet type 3 years ago
multiprocess.md multiprocess: Add comments and documentation 4 years ago
multisig-tutorial.md Add multisig tutorial 3 years ago
p2p-bad-ports.md net: open p2p connections to nodes that listen on non-default ports 3 years ago
productivity.md doc: Add libnatpmp stuff 4 years ago
psbt.md doc: M-of-N multisig using descriptor wallets and PSBTs, as well as a signing flow 3 years ago
reduce-memory.md doc: update reduce-memory.md peer connections info 4 years ago
reduce-traffic.md
release-notes.md Merge bitcoin/bitcoin#22834: net: respect -onlynet= when making outbound connections 3 years ago
release-process.md Merge bitcoin/bitcoin#24263: doc: Fix gen-manpages, rewrite in Python 3 years ago
shared-libraries.md doc: libbitcoinconsensus: add missing error code description, fix NBitcoin link 4 years ago
tor.md Merge bitcoin/bitcoin#22834: net: respect -onlynet= when making outbound connections 3 years ago
tracing.md tracing: misc follow-ups to 22902 3 years ago
translation_process.md doc: Remove unnecessary steps from translations update process 3 years ago
translation_strings_policy.md
zmq.md doc: Improve ZMQ documentation 3 years ago

README.md

Bitcoin Core

Setup

Bitcoin Core is the original Bitcoin client and it builds the backbone of the network. It downloads and, by default, stores the entire history of Bitcoin transactions, which requires a few hundred gigabytes of disk space. Depending on the speed of your computer and network connection, the synchronization process can take anywhere from a few hours to a day or more.

To download Bitcoin Core, visit bitcoincore.org.

Running

The following are some helpful notes on how to run Bitcoin Core on your native platform.

Unix

Unpack the files into a directory and run:

  • bin/bitcoin-qt (GUI) or
  • bin/bitcoind (headless)

Windows

Unpack the files into a directory, and then run bitcoin-qt.exe.

macOS

Drag Bitcoin Core to your applications folder, and then run Bitcoin Core.

Need Help?

Building

The following are developer notes on how to build Bitcoin Core on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.

Development

The Bitcoin repo's root README contains relevant information on the development process and automated testing.

Resources

Miscellaneous

License

Distributed under the MIT software license.