Install & Run a Node¶
Platform Downloads¶
Pre-built binaries for all platforms are available in each release:
| Platform | Architecture | Link |
|---|---|---|
| Linux | x86_64 | Download |
| Linux | ARM64 (Raspberry Pi 4/5) | Download |
| macOS | Intel & Apple Silicon | Download |
| Windows | x64 | Download |
| Docker | All platforms | Docker Hub |
Easiest Method
Docker is the fastest way to run a node on any platform:
Quick Start¶
# Start the daemon
./soqucoind -daemon
# Check sync status
./soqucoin-cli getblockchaininfo
# Get a new address
./soqucoin-cli getnewaddress
Configuration¶
Create ~/.soqucoin/soqucoin.conf:
# Basic node configuration
server=1
daemon=1
txindex=1
# RPC access (required for mining and CLI tools)
rpcuser=your_rpc_user
rpcpassword=your_rpc_password
rpcallowip=127.0.0.1
# Network (Stagenet)
port=44556
rpcport=44555
Mining Configuration¶
If you plan to run the SOQ Solo Miner, add ZMQ support:
server=1
daemon=1
txindex=1
# RPC
rpcuser=soqucoin
rpcpassword=YOUR_SECURE_PASSWORD
rpcallowip=127.0.0.1
rpcport=44555
rpcworkqueue=128
rpcthreads=8
# ZMQ (required for solo mining)
zmqpubhashblock=tcp://127.0.0.1:28332
Network Ports¶
| Network | P2P Port | RPC Port |
|---|---|---|
| Stagenet | 44556 | 44555 |
| Regtest | 18444 | 18332 |
Verify Installation¶
After starting the node, verify it's syncing:
# Check block height
./soqucoin-cli getblockcount
# View connected peers
./soqucoin-cli getpeerinfo | grep -c "addr"
# Network hashrate
./soqucoin-cli getnetworkhashps
Your node is fully synced when the block count matches the network height on SOQ-TEC.
Next Steps¶
- Configuration Reference — advanced node settings
- RPC API Reference — full JSON-RPC documentation
- Solo Mining Guide — mine blocks directly to your wallet
- Pool Mining Guide — join a mining pool