Skip to main content
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

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

​
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:

​
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

Build docs developers (and LLMs) love

Get started for freeTalk to us