> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incentiv.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Running an Incentiv Miner
> This guide walks you through configuring and running a miner for the Incentiv Mainnet.
## 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**
1. **RAM** 8 GB
2. **GPU:**
* **NVIDIA:** ≥ 4 GB VRAM, CUDA support (Compute Capability ≥ 5.0)
* **AMD:** ≥ 4 GB VRAM, OpenCL 1.2+ support
3. 50 GB free space on disk
4. **OS:** Ubuntu 22.04+ (to set up node)
5. **Drivers:**
* NVIDIA: CUDA 11.x+
* AMD: OpenCL drivers
***
Install the following:
* **glibc** 2.35+
* **Git**
* **Go** (version 1.22 or later)
* **make**
Debian/Ubuntu (Install Go 1.22+ from [golang.org](http://golang.org) or your package manager if it ships 1.22+)
```bash theme={null}
sudo apt update
sudo apt install -y git build-essential
```
Create a project directory and navigate into it
```bash theme={null}
mkdir -p ~/incentiv/node
cd ~/incentiv/node
```
Clone the client repository
```bash theme={null}
git clone https://github.com/IncentivNetwork/incentum-pow.git client
cd client
```
Build the client executable
```bash theme={null}
make geth
```
The binary will be at:
./build/bin/geth
Create a data directory and generate a new account (you’ll be prompted for a password):
```bash theme={null}
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:
```shellscript theme={null}
cat > pwd.txt
# Type your password here
# Press Enter, then press Ctrl+D (to save and exit)
```
```shellscript theme={null}
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, which defines the initial state of the Mainnet blockchain.
Create and open the genesis file for editing:
```bash theme={null}
nano ~/incentiv/node/genesis.json
```
Paste the following **as-is** and save:
```json theme={null}
{
"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`).
```bash theme={null}
cd ~/incentiv/node
./client/build/bin/geth init --datadir data/ genesis.json
```
To ensure the node runs continuously in the background and restarts automatically, we will create a `systemd` service.
Create a new service file:
```shellscript theme={null}
sudo nano /etc/systemd/system/incentum.service
```
Paste, then replace the placeholders as noted:
```ini theme={null}
[Unit]
Description=Incentum Node Service
After=network.target
[Service]
# --- Replace '' with your Linux username (e.g., ubuntu)
User=
Group=
WorkingDirectory=/home//incentiv
ExecStart=/home//incentiv/node/client/build/bin/geth \
--datadir /home//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 "" \
--allow-insecure-unlock \
--password /home//incentiv/node/pwd.txt \
--miner.etherbase "" \
--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 `` with your Linux username (e.g., `ubuntu`, `debian`, `admin`).
* Both instances of `` 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:
```text theme={null}
--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.
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
```shellscript theme={null}
sudo systemctl daemon-reload
sudo systemctl enable incentum.service
sudo systemctl start incentum.service
```
***Your Incentiv Mainnet node is now running.***
## Setup Miner
* Create a folder for the miner
* Download the ubqminer that supports AMD and NVIDIA.
* Make it executable
```shellscript theme={null}
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
```
```shellscript theme={null}
sudo nano /etc/systemd/system/ubqminer.service
```
Paste the following configuration:
```ini theme={null}
[Unit]
Description=Ubiq Miner Service
After=network-online.target
Wants=network-online.target
[Service]
User=
Group=
WorkingDirectory=/home//miner
ExecStart=/home//miner/ubqminer -P http://.worker@127.0.0.1:8545/
StandardOutput=append:/home//miner/ubqminer.log
StandardError=append:/home//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 systemd to apply the new service, then enable it to start on boot:
```shellscript theme={null}
sudo systemctl daemon-reload
```
Start the miner service
```shellscript theme={null}
sudo systemctl enable --now ubqminer.service
```
Check the miner status
```shellscript theme={null}
sudo systemctl status ubqminer.service
```
You should see output indicating the service is **active (running)**.
```shellscript theme={null}
Logs are also written to /home/ /miner/ubqminer.log
```
Restart the service (after configuration changes, **if needed**)
```shellscript theme={null}
sudo systemctl restart ubqminer.service
```
### Useful commands
```bash theme={null}
# 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
```
***