Skip to content

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:

docker run -d -p 28333:28333 soqucoin/soqucoin soqucoind -stagenet

Quick Start

# Start the daemon on the current public network (stagenet)
./soqucoind -daemon -stagenet

# 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, the current public network)
stagenet=1
port=28333
rpcport=28332

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=28332
rpcworkqueue=128
rpcthreads=8

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

Network Ports

Network P2P Port RPC Port
Stagenet (current) 28333 28332
Mainnet (at launch) 33388 33389
Testnet 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