Running Bitcoin Core

Learn how to run bitcoind and bitcoin-qt on different platforms

Bitcoin Core provides multiple ways to run a full node. You can use the graphical interface (bitcoin-qt) or run it as a headless daemon (bitcoind).

Choosing Your Client

Bitcoin Core offers three main commands:

• bitcoin-qt - Full graphical user interface
• bitcoind - Headless daemon for servers and automation
• bitcoin - Wrapper command that supports subcommands like bitcoin gui, bitcoin node, and bitcoin rpc

The bitcoin wrapper command provides a unified interface. List all available subcommands with bitcoin help.

Running on Different Platforms

Unix/Linux

Unpack the files into a directory and run:

# GUI client
bin/bitcoin-qt

# Headless daemon
bin/bitcoind

# Using the wrapper
bin/bitcoin gui
bin/bitcoin node

1. Extract the archive

   tar -xzf bitcoin-*.tar.gz
   cd bitcoin-*/
   
2. Run the client

   Choose your preferred interface and start Bitcoin Core:

   ./bin/bitcoind -daemon
   
3. Verify it's running

   Check that the daemon is running:

   ./bin/bitcoin-cli getblockchaininfo
   

Windows

1. Extract files

   Unpack the downloaded archive to a directory of your choice.

2. Run Bitcoin Core

   Double-click bitcoin-qt.exe to launch the graphical interface.

   For the daemon version, open Command Prompt and run:

   bitcoind.exe
   

macOS

1. Install application

   Drag Bitcoin Core to your Applications folder.

2. Launch Bitcoin Core

   Open Bitcoin Core from your Applications folder or Launchpad.

For command-line usage:

/Applications/Bitcoin-Qt.app/Contents/MacOS/Bitcoin-Qt

First Run Setup

On first launch, Bitcoin Core will:

1. Prompt you to choose a data directory location
2. Begin downloading and verifying the blockchain
3. Create a wallet (optional)

Bitcoin Core downloads and stores the entire blockchain history. This requires several hundred gigabytes of disk space. Make sure you have adequate storage before starting.

Common Configuration Options

You can customize Bitcoin Core’s behavior using command-line options or a bitcoin.conf configuration file.

Data Directory

Specify where blockchain data is stored:

bitcoind -datadir=/path/to/data

Network Selection

Run on different networks:

# Testnet
bitcoind -testnet

# Signet
bitcoind -signet

# Regtest (for development)
bitcoind -regtest

Daemon Mode

Run bitcoind in the background:

bitcoind -daemon

Then interact with it using:

bitcoin-cli getblockchaininfo
bitcoin-cli help

Stopping Bitcoin Core

Gracefully shut down the node:

bitcoin-cli stop

Or from the GUI: File → Exit

Always shut down Bitcoin Core gracefully. Forced termination may corrupt the database and require reindexing.

Getting Help

If you encounter issues:

• Bitcoin Wiki: en.bitcoin.it/wiki
• Bitcoin StackExchange: bitcoin.stackexchange.com
• IRC: #bitcoin on Libera Chat (web.libera.chat)
• Forums: bitcointalk.org Technical Support board

Next Steps

Initial Block Download

Understand the IBD process and what to expect

Performance Optimization

Tune your node for better performance

Pruning

Reduce disk space requirements

Configuration

Learn about bitcoin.conf options