Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration Reference

Complete reference for Bitcoin-PoCX configuration options.

Bitcoin Core PoCX (bitcoin.conf)

Location

SetupPath
Manual~/.bitcoin-pocx/bitcoin.conf
Systemd/var/lib/bitcoin/.bitcoin/bitcoin.conf

Authentication

No configuration needed. Bitcoin Core creates a .cookie file automatically:

  • Mainnet: ~/.bitcoin-pocx/.cookie
  • Testnet: ~/.bitcoin-pocx/testnet/.cookie

RPC Password (Required for Mining)

server=1
rpcuser=bitcoinrpc
rpcpassword=YOUR_SECURE_PASSWORD

Network Options

OptionDescriptionDefault
testnet=1Use testnet0 (mainnet)
regtest=1Use regtest0

RPC Options

OptionDescriptionDefault
server=1Enable RPC server0
rpcuser=RPC username-
rpcpassword=RPC password-
rpcport=RPC port8332 (18332 testnet)
rpcbind=RPC bind address127.0.0.1
rpcallowip=Allow RPC from IP127.0.0.1

P2P Network Options

OptionDescriptionDefault
listen=1Accept incoming connections1
port=P2P port8333 (18333 testnet)
maxconnections=Max peer connections125
addnode=Add specific peer-
connect=Connect only to specific peers-

Wallet Options

OptionDescriptionDefault
disablewallet=1Disable wallet0
wallet=Load specific wallet-

Performance Options

OptionDescriptionDefault
dbcache=Database cache MB450
maxmempool=Mempool size MB300
prune=Prune blockchain MB0 (disabled)

Example Configurations

testnet=1
disablewallet=1
server=1
listen=1
maxconnections=40
dbcache=450

[test]
rpcport=18332

Solo Miner (Testnet, RPC Password)

testnet=1
server=1
rpcuser=bitcoinrpc
rpcpassword=YOUR_PASSWORD
listen=1
maxconnections=40
dbcache=450

[test]
rpcport=18332
wallet=mining

PoCX Miner (miner.yaml)

Location

Typically ~/bitcoin-pocx/miner.yaml or /var/lib/bitcoin/miner.yaml

Chain Configuration

chains:
  - name: 'local'                    # Friendly name
    rpc_transport: http              # Transport type
    rpc_host: '127.0.0.1'            # Node/pool host
    rpc_port: 18332                  # RPC port
    rpc_auth:                        # Auth (required for solo)
      type: user_pass
      username: 'bitcoinrpc'
      password: 'YOUR_PASSWORD'
    block_time_seconds: 120          # Block time
    submission_mode: wallet          # wallet or pool

Plot Configuration

plot_dirs:
  - '/path/to/plots'           # Directory containing plot files

Multiple plot directories:

plot_dirs:
  - '/mnt/disk1/plots'
  - path: '/mnt/disk2/plots'
  - path: '/mnt/disk3/plots'

Full Example (Solo Mining)

chains:
  - name: 'Bitcoin-PoCX Testnet'
    rpc_transport: http
    rpc_host: '127.0.0.1'
    rpc_port: 18332
    rpc_auth:
      type: user_pass
      username: 'bitcoinrpc'
      password: 'your_rpc_password'
    block_time_seconds: 120
    submission_mode: wallet

plot_dirs:
  - '/home/user/plots'
  - path: '/mnt/external/plots'

Full Example (Pool Mining)

chains:
  - name: 'Testnet Pool'
    rpc_transport: https
    rpc_host: 'pool.testnet.bitcoin-pocx.org'
    rpc_port: 443
    block_time_seconds: 120
    submission_mode: pool

plot_dirs:
  - '/home/user/plots'

PoCX Plotter

Command Line Options

OptionDescription
-i, --idYour mining address (required)
-p, --pathOutput directory (required)
-w, --warpsSize in warps (1 warp = 1 GiB)
-x, --compressionCompression level (1, 2, or 4)
-c, --cpuCPU threads to use
-g, --gpuGPU(s) for plotting
-n, --numNumber of files (0 = fill disk)

Compression Levels

LevelSpace SavingsMining CPU Use
1 (X1)NoneLowest
2 (X2)~50%Medium
4 (X4)~75%Highest

Example

./pocx_plotter \
  -i tpocx1qyouraddress... \
  -p /mnt/plots \
  -w 500 \
  -x 1 \
  -c 4

Network Ports Reference

ServiceMainnetTestnet
Bitcoin P2P833318333
Bitcoin RPC833218332

File Locations Reference

FilePurpose
~/.bitcoin-pocx/bitcoin.confNode configuration
~/.bitcoin-pocx/.cookieCookie auth (mainnet)
~/.bitcoin-pocx/testnet/.cookieCookie auth (testnet)
~/.bitcoin-pocx/testnet/Testnet blockchain data
~/.bitcoin-pocx/wallets/Wallet files
~/.bitcoin-pocx/debug.logNode logs (mainnet)
~/.bitcoin-pocx/testnet/debug.logNode logs (testnet)