Setup Guides

Get Started with XenBlocksMiner

Complete step-by-step tutorials for Windows, Linux, HiveOS, and Vast.ai.
Easy setup, powerful mining. Choose your platform below.

Interactive Command Generator

Generate your custom mining command with just a few clicks

Your Ethereum-compatible wallet address (with proper checksum)
Support development (0-100%). Default: 5%
Mine XUNI blocks continuously instead of time-restricted windows

Platform-Specific Tutorials

Windows Setup Guide

Easy
1

Download XenBlocksMiner

Download the latest Windows release from our download page:

Download Windows v1.0.0 Beta
2

Extract the Archive

Right-click the downloaded ZIP file and select "Extract All..." to a folder of your choice.

3

Open Command Prompt

Navigate to the extracted folder and open Command Prompt:

  • Hold Shift and right-click in the folder
  • Select "Open PowerShell window here" or "Open Command window here"
4

Run the Miner

Execute the mining command (use the Command Generator above to create your custom command):

xenblocksMiner.exe --minerAddr YOUR_WALLET_ADDRESS --donate 5
5

Monitor Your Mining

The miner will display real-time statistics including:

  • Hashrate per GPU
  • Blocks found (Normal, Super, XUNI)
  • Memory usage and temperature
  • Submission status

💡 Pro Tips

  • Use --device 0,1 to specify which GPUs to use
  • Enable Web API with --enableWebApi --apiPort 8080 for remote monitoring
  • Use --xuniMode for continuous XUNI block mining
  • Add --dataDir "C:\MiningData" to store config and database in a custom location

Linux Setup Guide

Easy
1

Download XenBlocksMiner

We offer two Linux versions:

Recommended
AppImage (Portable)

Works on any Linux distribution. No installation needed!

wget https://xnm.pub/downloads/xenblocksMiner-portable.AppImage
chmod +x xenblocksMiner-portable.AppImage
TAR.GZ Archive

Traditional installation method

wget https://xnm.pub/downloads/xenblocksMiner-linux-v1.0.0.tar.gz
tar -xzf xenblocksMiner-linux-v1.0.0.tar.gz
cd xenblocksMiner
chmod +x xenblocksMiner
2

Verify NVIDIA Drivers

Ensure you have NVIDIA drivers and CUDA installed:

nvidia-smi

If this command fails, install NVIDIA drivers for your distribution.

3

Run the Miner

For AppImage:

./xenblocksMiner-portable.AppImage --minerAddr YOUR_WALLET_ADDRESS --donate 5

For TAR.GZ:

./xenblocksMiner --minerAddr YOUR_WALLET_ADDRESS --donate 5
4

Run in Background (Optional)

Use screen or tmux to keep mining after closing the terminal:

# Install screen
sudo apt install screen -y

# Create a new screen session
screen -S xenblocks

# Run miner
./xenblocksMiner-portable.AppImage --minerAddr YOUR_WALLET_ADDRESS --donate 5

# Detach: Press Ctrl+A, then D
# Reattach later: screen -r xenblocks

💡 Pro Tips

  • The AppImage is self-contained and works on Ubuntu, Debian, Fedora, Arch, and more
  • Use --device 0,1 to select specific GPUs
  • Monitor with Web API: --enableWebApi --apiPort 8080
  • Create a systemd service for automatic startup on boot

HiveOS Setup Guide

Medium
1

Login to HiveOS

Access your HiveOS farm at hiveon.com

2

Create a Wallet

  • Go to the Wallets tab
  • Click "Add Wallet"
  • Select "XenBlocks" as the coin (or create custom)
  • Enter your wallet address
3

Create Flight Sheet

  • Go to Flight Sheets
  • Click "Create Flight Sheet"
  • Coin: XenBlocks (or custom)
  • Wallet: Select your wallet
  • Miner: Select "Custom"
4

Configure Custom Miner

Miner name: xenblocksminer

Installation URL:

https://xnm.pub/downloads/xenblocksMiner-v1.0.0-hiveos.tar.gz

Hash algorithm: argon2id

Wallet and worker template:

%WAL%

Extra config arguments:

--minerAddr %WAL% --donate 5
5

Advanced Configuration (Optional)

For specific GPU selection or custom settings:

--minerAddr %WAL% --donate 5 --device 0,1,2 --xuniMode
6

Apply Flight Sheet

  • Save the flight sheet
  • Apply it to your worker/rig
  • Wait for the miner to start
  • Monitor GPU usage and hashrate

💡 Pro Tips

  • Only NVIDIA GPUs are supported
  • Use --device 0,2,4 to select specific GPUs
  • Monitor rig stats through HiveOS dashboard
  • Set up Telegram notifications for worker issues

Vast.ai Setup Guide

Easy

Use our pre-configured Vast.ai template for quick setup. XenBlocksMiner runs directly without Docker for better performance!

1

Use the XNM.pub Template

Open our public template: XenblocksMiner Vast.ai Template

Before renting, click 'Edit', go to 'On-start Script', and replace:

  • YOUR_WALLET_ADDRESS - Your Ethereum wallet address
  • YOUR_DONATE_PERCENT - Your donation percentage (e.g., 1 for 1%)
2

Configuration Options

The template includes these options:

  • --xuniMode - Enabled by default; continuously mines XUNI blocks
  • --testDifficulty 20000 - (Optional) Caps the maximum mining difficulty. Without this flag, the miner always mines at network difficulty and submits blocks immediately.

⚠️ testDifficulty Warning: When network difficulty exceeds your cap, blocks are queued locally in blocks.db and submitted only when difficulty drops. If you shut down your Vast instance before queued blocks are submitted, they may be lost forever (unless you copy blocks.db to another machine). Don't set this value too low!

3

Launch Instance

  • Filter for NVIDIA GPUs (RTX 3080, RTX 4090, etc.)
  • Sort by "$ per GPU" for best value
  • Check CUDA version (11.0 or higher)
  • Click "Rent" and confirm
  • Wait for instance to start (1-2 minutes)
4

Monitor Your Miner

Connect via SSH to check status:

# Connect to instance (use SSH button in Vast.ai console)
ssh root@your-instance-ip

# View miner output
screen -r miner

# Detach from screen: Ctrl+A, then D
# Check GPU usage
nvidia-smi
5

Verify Mining

  • GPU usage should be near 100%
  • Check console output for hashrate
  • Look for "Block found" messages
  • If GPU usage is 0%, check the screen session for errors

💡 Alternative: Custom On-Start Script

Or create your own template with this script:

#!/bin/bash
env >> /etc/environment
apt-get update && apt-get install -y screen wget unzip
cd /root
wget -N https://xnm.pub/downloads/xenblocks-lin.zip
unzip -o xenblocks-lin.zip
chmod +x xenblocks
screen -dmS miner ./xenblocks --minerAddr YOUR_WALLET_ADDRESS --donate YOUR_DONATE_PERCENT --xuniMode --testDifficulty 20000

⚠️ Replace YOUR_WALLET_ADDRESS and YOUR_DONATE_PERCENT with your values!

⚠️ Cost Management

Remember to destroy instances when not needed to avoid unnecessary charges. Check your Vast.ai billing regularly.

Frequently Asked Questions

What's the difference from other miners?

XenBlocks Miner by Xen.pub is an optimized fork with improved CUDA kernels, better block detection, SQLite-based block storage with retry logic, XUNI continuous mining mode, and a Web API for monitoring. No Docker required, but it can still be containerized if needed!

Which GPUs are supported?

NVIDIA GPUs with CUDA compute capability 3.5 or higher. Best performance on RTX 30/40 series, but older cards work too.

What's the recommended dev fee?

We suggest 5% to support continued development, but you can set any value from 0-100%.

Can I mine on multiple rigs?

Yes! Use the same wallet address on all rigs. Each instance mines independently.

What are XUNI blocks?

Time-sensitive specialty blocks (XUNI0-XUNI9) valid only during 5-minute windows each hour (XX:55-XX:05). Use --xuniMode to mine them continuously.

How do I check my wallet balance?

Use an X1 blockchain explorer or check your wallet through compatible tools. Blocks are submitted directly to the XenBlocks network.

Need Help?

Join our community or contact support

Twitter GitHub Email Support