Running an Incentiv Miner

Quick facts

Client: Incentum (Geth-based)
Chain ID: 24101 (Mainnet)
Consensus: Ethash (PoW)
RPC (local by default): HTTP :8545, WS :8546
Datadir: ~/incentiv/node/data (in this guide)

Minimal Requirements

RAM 8 GB
GPU:
- NVIDIA: ≥ 4 GB VRAM, CUDA support (Compute Capability ≥ 5.0)
- AMD: ≥ 4 GB VRAM, OpenCL 1.2+ support
50 GB free space on disk
OS: Ubuntu 22.04+ (to set up node)
Drivers:
- NVIDIA: CUDA 11.x+
- AMD: OpenCL drivers

Prerequisites

Install the following:

glibc 2.35+
Git
Go (version 1.22 or later)
make

Debian/Ubuntu (Install Go 1.22+ from golang.org or your package manager if it ships 1.22+)

sudo apt update
sudo apt install -y git build-essential

Clone & Build the Client

Create a project directory and navigate into it

mkdir -p ~/incentiv/node
cd ~/incentiv/node        

Clone the client repository

git clone https://github.com/IncentivNetwork/incentum-pow.git client
cd client

Build the client executable

make geth

The binary will be at:./build/bin/geth

Account & Environment Setup

Create a data directory and generate a new account (you’ll be prompted for a password):

cd ~/incentiv/node
mkdir -p data
./client/build/bin/geth account new --datadir data/

Save your password to a file that your System Service can read:

cat
nano

cat > pwd.txt
# Type your password here
# Press Enter, then press Ctrl+D (to save and exit)

nano pwd.txt
# Type your password.
# Ctrl+O (Save), Enter, Ctrl+X (Exit).

Note your public address (e.g. 0x...) for the service config.

Create the genesis.json File

Create the genesis.json file, which defines the initial state of the Mainnet blockchain.Create and open the genesis file for editing:

nano ~/incentiv/node/genesis.json

Paste the following as-is and save:

{
  "config": {
    "chainId": 24101,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip155Block": 0,
    "eip158Block": 0,
    "byzantiumBlock": 0,
    "constantinopleBlock": 0,
    "petersburgBlock": 0,
    "istanbulBlock": 0,
    "berlinBlock": 0,
    "londonBlock": 0,
    "feePoolBlock": 0,
    "zeroRewardBlock": 0,
    "fastBlock": 0,
    "shanghaiTime": 1755203160,
    "ethash": {}
  },
  "nonce": "0x42",
  "timestamp": "0x0",
  "extraData": "0x",
  "gasLimit": "0x1c9c380",
  "difficulty": "0x1",
  "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "coinbase": "0x0000000000000000000000000000000000000000",
  "alloc": {
    "d2cc08d9afabb57bdf2216ed15fceaa9993f3b7b": {
      "balance": "0x1431e0fae6d7217caa0000000"
    }
  },
  "number": "0x0",
  "gasUsed": "0x0",
  "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "baseFeePerGas": "0x1a3185c5000"
}

Save the file and exit the editor (in nano, press Ctrl+X, then Y, then Enter).

Initialize the Chain Data

cd ~/incentiv/node
./client/build/bin/geth init --datadir data/ genesis.json

Configure a System Service

To ensure the node runs continuously in the background and restarts automatically, we will create a systemd service.Create a new service file:

sudo nano /etc/systemd/system/incentum.service

Paste, then replace the placeholders as noted:

[Unit]
Description=Incentum Node Service
After=network.target

[Service]
# --- Replace '<YOUR_USERNAME>' with your Linux username (e.g., ubuntu)
User=<YOUR_USERNAME>
Group=<YOUR_USERNAME>
WorkingDirectory=/home/<YOUR_USERNAME>/incentiv

ExecStart=/home/<YOUR_USERNAME>/incentiv/node/client/build/bin/geth \
  --datadir /home/<YOUR_USERNAME>/incentiv/node/data \
  --incentiv-mainnet \
  --http \
  --http.addr "127.0.0.1" \
  --http.port 8545 \
  --http.api "eth,net,web3,txpool" \
  --ws \
  --ws.addr "127.0.0.1" \
  --ws.port 8546 \
  --ws.api "eth,net,web3" \
  --unlock "<YOUR_ACCOUNT_ADDRESS_HERE>" \
  --allow-insecure-unlock \
  --password /home/<YOUR_USERNAME>/incentiv/node/pwd.txt \
  --miner.etherbase "<YOUR_ACCOUNT_ADDRESS_HERE>" \
  --mine \
  --miner.threads=-1 \
  --syncmode=snap \
  --cache=4096 \
  --maxpeers=50 \
  --bootnodes=enode://b5f3d8d38136f9252a90c694d66769eef66b393611a4b023df78795beddaa788116f41029dcf2dc59168542968747b252be35293f7fdd7717394ece84e73baf7@195.189.60.152:30303,enode://370ac0ca0f1861fc06df79f298ec50129284cde15087e4a21440b657cfe3a735c939aecb8b625751dae221991c4151a2923c61d4f376d418369881fb2aebf85c@144.217.77.103:30303,enode://7040a8dc9e7040cf8c78b7fa4dfff0648744e6c969d77811aa6fcd01ef224a283f4d6cd3b7d2eb6922f1fcf0673e0ce1283e1d9b38e2e6266c99372ea9408651@51.79.21.182:30303,enode://597248d1216230f1fce650c84939e6ea5bfffe82ba8ad71a1d0adfd5bb073d37772e71d068bad7db5dc28688c537cb4d0d00b6eee80b1c0b3e6c79d30cff42e7@51.255.64.209:30303,enode://6e2c9c5d60f7e16bb1f80328dc23b0b7b28e500e17c936689d7684c30e4f7cc450ce88cb7536e120e02023a66ac8d68def346bcc2a416376f9dfbd13b7dc3b88@141.94.161.120:30303

Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Before saving, make sure you replace:

All instances of <YOUR_USERNAME> with your Linux username (e.g., ubuntu, debian, admin).
Both instances of <YOUR_ACCOUNT_ADDRESS_HERE> with the public wallet address generated in Step 3.

Additional bootnodes:

enode://370ac0ca0f1861fc06df79f298ec50129284cde15087e4a21440b657cfe3a735c939aecb8b625751dae221991c4151a2923c61d4f376d418369881fb2aebf85c@144.217.77.103:30303
enode://7040a8dc9e7040cf8c78b7fa4dfff0648744e6c969d77811aa6fcd01ef224a283f4d6cd3b7d2eb6922f1fcf0673e0ce1283e1d9b38e2e6266c99372ea9408651@51.79.21.182:30303
enode://597248d1216230f1fce650c84939e6ea5bfffe82ba8ad71a1d0adfd5bb073d37772e71d068bad7db5dc28688c537cb4d0d00b6eee80b1c0b3e6c79d30cff42e7@51.255.64.209:30303
enode://6e2c9c5d60f7e16bb1f80328dc23b0b7b28e500e17c936689d7684c30e4f7cc450ce88cb7536e120e02023a66ac8d68def346bcc2a416376f9dfbd13b7dc3b88@141.94.161.120:30303

To allow for continuity in the event of failure, specify all bootnodes in a comma-separated list using the —bootnodes option for each node, including the bootnodes.For example:

--bootnodes=enode://b5f3d8d38136f9252a90c694d66769eef66b393611a4b023df78795beddaa788116f41029dcf2dc59168542968747b252be35293f7fdd7717394ece84e73baf7@195.189.60.152:30303,enode://370ac0ca0f1861fc06df79f298ec50129284cde15087e4a21440b657cfe3a735c939aecb8b625751dae221991c4151a2923c61d4f376d418369881fb2aebf85c@144.217.77.103:30303,enode://7040a8dc9e7040cf8c78b7fa4dfff0648744e6c969d77811aa6fcd01ef224a283f4d6cd3b7d2eb6922f1fcf0673e0ce1283e1d9b38e2e6266c99372ea9408651@51.79.21.182:30303,enode://597248d1216230f1fce650c84939e6ea5bfffe82ba8ad71a1d0adfd5bb073d37772e71d068bad7db5dc28688c537cb4d0d00b6eee80b1c0b3e6c79d30cff42e7@51.255.64.209:30303,enode://6e2c9c5d60f7e16bb1f80328dc23b0b7b28e500e17c936689d7684c30e4f7cc450ce88cb7536e120e02023a66ac8d68def346bcc2a416376f9dfbd13b7dc3b88@141.94.161.120:30303

Having each bootnode include the other bootnodes increases the speed of discovery. Nodes ignore their own enode in the bootnodes list so you can use the same bootnode list for all bootnodes.

Start & Manage the Node

After creating the service file, use the following commands to enable and start the node.

Reload the systemd manager configuration
Enable the service to start automatically on boot
Start the node service now

sudo systemctl daemon-reload

sudo systemctl enable incentum.service

sudo systemctl start incentum.service

Your Incentiv Mainnet node is now running.

Setup Miner

Download ubqminer

Create a folder for the miner
Download the ubqminer that supports AMD and NVIDIA.
Make it executable

cd ~
mkdir -p miner
cd miner

wget https://github.com/ubiq/ubqminer/releases/download/v0.20.1/ubqminer-0.20.1-cuda12.6-linux-x86_64.tar.gz
tar -xzf ubqminer-0.20.1-cuda12.6-linux-x86_64.tar.gz

chmod +x ubqminer

Create a New File

sudo nano /etc/systemd/system/ubqminer.service

Paste the following configuration:

[Unit]
Description=Ubiq Miner Service
After=network-online.target
Wants=network-online.target

[Service]
User=<YOUR_USERNAME>
Group=<YOUR_USERNAME>
WorkingDirectory=/home/<YOUR_USERNAME>/miner
ExecStart=/home/<YOUR_USERNAME>/miner/ubqminer -P http://<YOUR_ACCOUNT_ADDRESS_HERE>.worker@127.0.0.1:8545/
StandardOutput=append:/home/<YOUR_USERNAME>/miner/ubqminer.log
StandardError=append:/home/<YOUR_USERNAME>/miner/ubqminer.log
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Save the file and exit the editor (in nano, press Ctrl+X, then Y, then Enter).

Reload & Enable

Reload systemd to apply the new service, then enable it to start on boot:

sudo systemctl daemon-reload

Start the miner service

sudo systemctl enable --now ubqminer.service

Check the miner status

sudo systemctl status ubqminer.service

You should see output indicating the service is active (running).

Logs are also written to /home/ <YOUR_USERNAME> /miner/ubqminer.log

Restart the service (after configuration changes, if needed)

sudo systemctl restart ubqminer.service

Useful commands

# Check the status of the Service:
sudo systemctl status ubqminer.service

# Stop the Service
sudo systemctl stop ubqminer.service

# Restart the Service
sudo systemctl restart ubqminer.service

​Quick facts

​Minimal Requirements

​Setup Miner

​Useful commands

Quick facts

Minimal Requirements

Setup Miner

Useful commands