Configuration Reference¶

All configuration is done through ~/.soqucoin/soqucoin.conf or via command-line flags.

Config File Location¶

OS	Path
Linux	`~/.soqucoin/soqucoin.conf`
macOS	`~/Library/Application Support/Soqucoin/soqucoin.conf`
Windows	`%APPDATA%\Soqucoin\soqucoin.conf`
Docker	Mounted via `-v soqucoin-data:/root/.soqucoin`

Network Settings¶

# Listen for incoming peer connections
listen=1

# P2P port (default: 44556)
port=44556

# Maximum number of peer connections
maxconnections=125

# Add a specific seed node
addnode=seed1.soqu.org
addnode=seed2.soqu.org

RPC Settings¶

Required for CLI tools, mining, and API access.

# Enable RPC server
server=1

# RPC credentials
rpcuser=your_username
rpcpassword=your_password

# RPC port (default: 44555)
rpcport=44555

# Allow RPC from localhost only (recommended)
rpcallowip=127.0.0.1

# Performance (increase for mining workloads)
rpcworkqueue=128
rpcthreads=8

Security

Never expose RPC to the public internet. Use rpcallowip=127.0.0.1 and firewall rules to restrict access.

Mining Settings¶

# ZMQ block notifications (required for solo miner)
zmqpubhashblock=tcp://127.0.0.1:28332

# Generate blocks (regtest only)
# gen=1

Storage Settings¶

# Maintain a full transaction index (recommended)
txindex=1

# Prune old blocks to save disk space
# prune=550  # Keep ~550 MB of block data

# Custom data directory
# datadir=/path/to/data

Logging¶

# Enable debug logging (verbose)
# debug=1

# Log to file instead of stdout
# debuglogfile=/path/to/debug.log

# Shrink debug.log on startup (default: 1)
shrinkdebugfile=1

Regtest Settings¶

For local development:

regtest=1
port=18444
rpcport=18332

Full Example (Mining Node)¶

# Soqucoin Mining Node Configuration

# Network
server=1
listen=1
daemon=1
port=44556

# RPC
rpcuser=soqucoin
rpcpassword=CHANGE_THIS_TO_A_STRONG_PASSWORD
rpcallowip=127.0.0.1
rpcport=44555
rpcworkqueue=128
rpcthreads=8

# Data
txindex=1

# ZMQ (for solo miner)
zmqpubhashblock=tcp://127.0.0.1:28332

# Performance
maxconnections=40

Command-Line Flags¶

Any config option can also be passed as a flag:

soqucoind -daemon -server -rpcuser=soqucoin -rpcpassword=mypass -port=44556

Flags override config file values.