Mainnet Docker Setup

Using the available Docker image is fairly easy to run a Bitcoin Mainnet node.

Step 1: Install Docker

Follow instructions to install Docker here.

Step 2: Run Mainnet node using Docker:

Pull the correct Bitcoin image and run:

docker run -d \
  --name bitcoin-mainnet \
  -p 8332:8332 \
  -p 8333:8333 \
  bitcoin/bitcoin:30 \
  -printtoconsole \
  -rest \
  -rpcbind=0.0.0.0 \
  -rpcallowip=0.0.0.0/0 \
  -rpcport=8332 \
  -rpcuser=citrea \
  -rpcpassword=citrea \
  -server \
  -txindex=1

Bitcoin Mainnet node should be running in your system. You can check it with the following command:

curl --user citrea --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockcount", "params": []}' -H 'content-type: text/plain;' http://0.0.0.0:8332

The --user flag and the password are the rpcuser and rpcpassword values that you used to run the Docker command above.

Now you can proceed to run the Citrea client from here.

Testnet4 setup: To run a Bitcoin Testnet4 node for Citrea's testnet, add the -testnet4=1 flag and use the testnet4 ports (18443 for RPC, 18444 for P2P):

docker run -d \
  --name bitcoin-testnet4 \
  -p 18443:18443 \
  -p 18444:18444 \
  bitcoin/bitcoin:29 \
  -printtoconsole \
  -testnet4=1 \
  -rest \
  -rpcbind=0.0.0.0 \
  -rpcallowip=0.0.0.0/0 \
  -rpcport=18443 \
  -rpcuser=citrea \
  -rpcpassword=citrea \
  -server \
  -txindex=1

Then check it with http://0.0.0.0:18443 instead of http://0.0.0.0:8332.

---

If you do not want to use Docker to setup a Bitcoin node, you can build it from the source code here.