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
glozow 99eeb51bf6
[doc] mention bip94 support
3 months ago
..
design doc: Remove reference to resolved issue 3 months ago
man
policy [doc] update documentation for new mempoolfullrbf default 3 months ago
release-notes [doc] archive v26.2 release notes 4 months ago
.gitignore
Doxyfile.in
JSON-RPC-interface.md minor: remove unnecessary semicolons from RPC content type examples 5 months ago
README.md build, test, doc: Temporarily remove Android-related stuff 6 months ago
README_doxygen.md
README_windows.txt
REST-interface.md testnet: Introduce Testnet4 3 months ago
assets-attribution.md
benchmarking.md
bips.md [doc] mention bip94 support 3 months ago
bitcoin-conf.md system: use %LOCALAPPDATA% as default datadir on windows 6 months ago
bitcoin_logo_doxygen.png
build-freebsd.md doc: suggest only necessary Qt packages for installation on FreeBSD 7 months ago
build-netbsd.md doc: Update NetBSD Build Guide 6 months ago
build-openbsd.md doc: mention optional dependencies (qrencode, zmq) in OpenBSD build docs 3 months ago
build-osx.md doc: add LLVM instruction for macOS < 13 6 months ago
build-unix.md Merge bitcoin/bitcoin#29756: doc: Override `-g` properly to skip debugging information 7 months ago
build-windows.md Merge bitcoin/bitcoin#30580: doc: Add note about distro's `g++-mingw-w64-x86-64-posix` version 3 months ago
cjdns.md
dependencies.md build: Bump clang minimum supported version to 16 4 months ago
descriptors.md tests: improve wallet multisig descriptor test and docs 6 months ago
developer-notes.md Fix lint-spelling warnings 4 months ago
dnsseed-policy.md Update the developer mailing list address. 7 months ago
external-signer.md wallet: compare address returned by displayaddress 7 months ago
files.md Merge bitcoin/bitcoin#29775: Testnet4 including PoW difficulty adjustment fix 3 months ago
fuzzing.md doc: remove references to disable-asm option now that it's gone 8 months ago
guix.md
i2p.md doc: i2p: improve `-i2pacceptincoming` mention 7 months ago
init.md Merge bitcoin/bitcoin#28167: init: Add option for rpccookie permissions (replace 26088) 4 months ago
managing-wallets.md Merge bitcoin/bitcoin#27064: system: use %LOCALAPPDATA% as default datadir on windows 6 months ago
multiprocess.md doc: Add multiprocess design doc 11 months ago
multisig-tutorial.md doc: remove obsolete mention and link to closed PR 3 months ago
offline-signing-tutorial.md doc: update signet faucet link in offline-signing-tutorial.md 8 months ago
p2p-bad-ports.md
productivity.md doc: Update ccache website link 3 months ago
psbt.md
reduce-memory.md
reduce-traffic.md doc: update/clarify max outbound connection count 11 months ago
release-28984.md Add release note for size 2 package rbf 5 months ago
release-notes-22729.md doc: add release notes for #22729 3 months ago
release-notes-27101.md doc: update and link for JSON-RPC 2.0 5 months ago
release-notes-27114.md docs: add release notes for #27114 8 months ago
release-notes-27307.md wallet: update mempool conflicts tests + docs 4 months ago
release-notes-27375.md doc: add release notes and help text for unix sockets 8 months ago
release-notes-27679.md doc: release notes for PR 27679 7 months ago
release-notes-28052.md Add -blocksxor boolean option 3 months ago
release-notes-29091-29165.md build: Bump clang minimum supported version to 16 4 months ago
release-notes-29496.md [doc] add release note for TRUC 4 months ago
release-notes-29612.md doc: Add release notes for #29612 6 months ago
release-notes-29775.md doc: Add release notes for 29775 3 months ago
release-notes-29845.md rpc: return warnings as an array instead of just a single one 6 months ago
release-notes-29987.md guix: use glibc 2.31 5 months ago
release-notes-30058.md introduce and use the generalized `node::Warnings` interface 5 months ago
release-notes-30192.md build: remove --enable-lcov-branch-coverage 5 months ago
release-notes-30212.md doc: release note for 30212 3 months ago
release-notes-30275.md [doc]: add `30275` release notes 3 months ago
release-notes-30352.md Add release note for P2A output feature 3 months ago
release-notes-30482.md doc: Add release notes for two pull requests 4 months ago
release-notes-30493.md doc: add release notes for full-rbf 3 months ago
release-notes-empty-template.md doc: add minimum required Linux Kernel to release-notes 11 months ago
release-process.md testnet: Introduce Testnet4 3 months ago
tor.md doc: tor.md: use -bind=127.0.0.1:8334=onion for the Tor bind 3 months ago
tracing.md
translation_process.md doc: Update translation_process.md 9 months ago
translation_strings_policy.md
zmq.md validationinterface: only send zmq notifications for active 1 year 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.