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
fanquake 4fb82e916b
Merge #17567: gui: remove macOS start on login code
5 years ago
..
man doc: remove OpenSSL from build instructions and licensing info 5 years ago
release-notes doc: Add historical release notes for 0.19.0.1 5 years ago
.gitignore Ignore Doxyfile generated from Doxyfile.in template. 8 years ago
Doxyfile.in doc: Move doxygen intro to file for USE_MDFILE_AS_MANPAGE 5 years ago
JSON-RPC-interface.md doc: Clarify RPC versioning 6 years ago
README.md doc: Change doxygen URL to doxygen.bitcoincore.org 5 years ago
README_doxygen.md doc: Improve doxygen readme navigation section 5 years ago
README_windows.txt doc: Remove version numbers from READMEs 8 years ago
REST-interface.md doc: Remove explicit network name references 5 years ago
assets-attribution.md
benchmarking.md [doc] fix Makefile target in benchmarking.md 5 years ago
bips.md doc: Update doc/bips.md with recent changes in master 5 years ago
bitcoin-conf.md doc: add default bitcoin.conf locations 5 years ago
bitcoin_logo_doxygen.png
build-freebsd.md doc: remove OpenSSL from build instructions and licensing info 5 years ago
build-netbsd.md doc: update NetBSD build instructions for 8.0 6 years ago
build-openbsd.md Merge #14515: doc: Update OpenBSD build guide for 6.4 6 years ago
build-osx.md build: set minimum supported macOS to 10.12 5 years ago
build-unix.md doc: Remove ssl as a required dependency from build-unix 5 years ago
build-windows.md doc: compiling with Visual Studio is now supported on Windows 5 years ago
dependencies.md Merge #17008: build: bump libevent to 2.1.11 in depends 5 years ago
descriptors.md Update descriptors.md to include sortedmulti 5 years ago
developer-notes.md Merge #17539: doc: Update and improve Developer Notes 5 years ago
dnsseed-policy.md
files.md doc: Add missing indexes/blockfilter/basic/ to doc/files.md 5 years ago
fuzzing.md docs: Add undefined to --with-sanitizers=fuzzer,address 5 years ago
gitian-building.md doc: move gitian building to external repo 7 years ago
init.md doc: Fix whitespace errs in .md files, bitcoin.conf, Info.plist.in, and find_bdb48.m4 5 years ago
productivity.md docs: Add productivity notes for "dummy rebases" 6 years ago
psbt.md doc: fix/improve analyzepsbt in doc/psbt.md 6 years ago
rapidcheck.md doc: initial RapidCheck property-based testing documentation 5 years ago
reduce-memory.md docs: add reduce-memory.md 5 years ago
reduce-traffic.md doc: Mention blocksonly in reduce-traffic.md, unhide option 6 years ago
release-notes-15437.md [docs] Add release notes for removal of REJECT reasons 5 years ago
release-notes-15954.md remove old bootstrap relevant code 5 years ago
release-notes-17056.md Add release note 5 years ago
release-notes-17410.md doc: Add relase note for db→walletdb rename 5 years ago
release-notes-17437.md rpc: Expose block height of wallet transactions 5 years ago
release-notes.md Merge #17567: gui: remove macOS start on login code 5 years ago
release-process.md build: use osslsigncode 2.0 in gitian 5 years ago
shared-libraries.md doc: correct bitcoinconsensus_version in shared-libraries 6 years ago
tor.md Elaborate on the need to re-login on Debian-based systems to use tor following usermod 5 years ago
translation_process.md build: Factor out qt translations from build system 5 years ago
translation_strings_policy.md A few textual improvements 6 years ago
zmq.md doc: Add note regarding ZMQ block notification 5 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.