The commands in this guide should be executed in a Terminal application.The built-in one is located in
Preparation
Bitcoin is a distributed, worldwide, decentralized digital money. Bitcoins are issued and managed without any central authority whatsoever: there is no government, company, or bank in charge of Bitcoin. You might be interested in Bitcoin if you like cryptography, distributed peer-to-peer systems, or economics.
Install the macOS command line tools:
When the popup appears, click
Install
.Then install Homebrew.
Dependencies
If you run into issues, check Homebrew's troubleshooting page.See dependencies.md for a complete overview.
If you want to build the disk image with
make deploy
(.dmg / optional), you need RSVG:Berkeley DB
It is recommended to use Berkeley DB 4.8. If you have to build it yourself,you can use this script to install itlike so:
from the root of the repository.
Note: You only need Berkeley DB if the wallet is enabled (see Disable-wallet mode).
Build Bitcoin Core
- Clone the Bitcoin Core source code:
- Build Bitcoin Core:Configure and build the headless Bitcoin Core binaries as well as the GUI (if Qt is found).You can disable the GUI build by passing
--without-gui
to configure. - It is recommended to build and run the unit tests:
- You can also create a
.dmg
that contains the.app
bundle (optional):
Mine Bitcoin Mac
disable-wallet
mode
When the intention is to run only a P2P node without a wallet, Bitcoin Core may becompiled in
disable-wallet
mode with:In this case there is no dependency on Berkeley DB 4.8.
Mining is also possible in disable-wallet mode using the
getblocktemplate
RPC call.Running
Bitcoin Core is now available at
./src/bitcoind
Before running, you may create an empty configuration file:
The first time you run bitcoind, it will start downloading the blockchain. This process couldtake many hours, or even days on slower than average systems.
You can monitor the download process by looking at the debug.log file:
Other commands:
Notes
- Tested on OS X 10.12 Sierra through macOS 10.15 Catalina on 64-bit Intelprocessors only.
- Building with downloaded Qt binaries is not officially supported. See the notes in #7714.
Follow these steps to use the Photos library repair tool:
- Hold down the Option and Command keys while you open Photos on your Mac.
- In the dialog that appears, click Repair to start the repair process.
You might be asked to type in your user account password to authorize the library repair.
The repair tool analyzes the the library's database and repairs any inconsistencies it detects. Depending on the size of your library, this might take some time. When the process is completed, Photos opens the library.
If you repair a library that's automatically updated with iCloud Photos, the entire contents of the library re-updates with iCloud after the repair process completes.