How to mine

How to mine XELIS

xelhash on your GPUs and CPU at the same time. Pool, wallet, and every platform.

Algorithm
xelhash (-a xelis)
Mines on
NVIDIA, AMD and Intel GPUs and the CPU, at the same time
Dev fee
1%
Wallet
Starts with xel:
Solo mining
Yes, against your own node
Launcher
start_xelis in the archive

XELIS is a privacy-oriented BlockDAG, and xelhash is unusual in that it runs well on both kinds of processor. bzminer uses every GPU it finds and the CPU on the same rig, all submitting to the same pool, so a gaming PC with one card still gets two workers out of one command.

Before you start

  • A XELIS wallet address. It starts with xel:. Any XELIS wallet gives you one; the pool pays to it directly, so there is no account to make.
  • A pool. Two that have been mined from this build:
    • stratum+ssl://us.vipor.net:5177 (vipor, TLS)
    • stratum+ssl://us.xelis.herominers.com:1225 (HeroMiners, TLS)
    Both are in the launcher; the second is a commented-out line you can swap in, or keep as a backup pool.
  • Hardware. Any NVIDIA card from Pascal (GTX 10xx) up, AMD and Intel Arc cards through OpenCL, and any x86-64 CPU. Nothing to install beyond the GPU driver.

The command

Everything on every platform comes down to this one line:

./bzminer \
  -a xelis \
  -p stratum+ssl://us.vipor.net:5177 \
  -w xel:YOUR_WALLET \
  --worker rig1
  • -a xelis — the algorithm.
  • -p — the pool URL. stratum+ssl:// is encrypted; stratum+tcp:// is plain. Give -p twice and the second pool is a backup.
  • -w — your wallet. bzminer sends wallet.worker to the pool, so do not add a worker suffix to the address yourself.
  • --worker rig1 — how this rig shows up on the pool’s page. You can leave it out.
Tip

To mine on the GPUs alone, add --nvidia (or --amd, --intel); to mine on the CPU alone, add --cpu. Naming a type makes it the only one that mines. --cpu_threads 8 caps how much of the processor joins in — by default bzminer holds one or two threads back so the machine stays usable. On a rig that also mines a CPU coin, keep XELIS off the CPU with --cpu1 0 (the number is XELIS’s position in -a); see which devices mine which algorithm.

Step by step, on your platform

Pick your platform. The steps are the same shape everywhere: get the archive, put your wallet in the launcher, run it, open the dashboard. Only the details change.

  1. Download and unzip

    Get bzminer_v100.82_windows.zip from the release page and unzip it anywhere you like — a folder on the desktop is fine. There is no installer and nothing is written outside that folder except the log. The SHA-256 of the archive is published beside it if you want to check the download.

  2. Put your wallet in the launcher

    Right-click start_xelis.bat, choose Edit, and replace the placeholder wallet with your own. The pool is already filled in; other pools are listed as commented-out lines in the same file. Save it.

  3. Run it

    Double-click the launcher. The console dashboard opens in a window. Or, from a command prompt in that folder, the same thing by hand:

    bzminer.exe -a xelis -p stratum+ssl://us.vipor.net:5177 -w xel:YOUR_WALLET --worker rig1

    Windows Terminal is the better console for it: the old conhost window cannot scroll the log pane with the mouse wheel and select text at the same time. Everything still works in the old console; it is just less convenient.

  4. Open the dashboard

    Browse to http://127.0.0.1:4014/ on the same machine. Nothing to install and nothing to sign in to.

Overclocking on Windows needs no special privileges for the power limit and the fan, and no administrator prompt to mine. CPU register tweaks that speed up some CPU algorithms are optional and use the PawnIO driver; install-pawnio.bat is in the archive for that, and mining carries on without it.

  1. Download and unpack

    wget https://github.com/bzminer/bzminer/releases/download/v100.82/bzminer_v100.82_linux.tar.gz
    tar -xzf bzminer_v100.82_linux.tar.gz
    cd bzminer_v100.82_linux

    A single static binary; no packages to install, and no CUDA toolkit or OpenCL SDK. The GPU driver is the only thing it needs from the system.

  2. Put your wallet in the launcher

    Open start_xelis.sh in any editor and replace the placeholder wallet. Other pools are in the same file as commented-out lines.

  3. Run it

    ./start_xelis.sh

    Or the same command written out, which is all the launcher does:

    ./bzminer \
      -a xelis \
      -p stratum+ssl://us.vipor.net:5177 \
      -w xel:YOUR_WALLET \
      --worker rig1

    If you redirect the output to a file or run it under a service manager, bzminer notices there is no terminal and switches to the plain scrolling log screen on its own, so the file is readable rather than full of cursor codes.

  4. Open the dashboard

    http://127.0.0.1:4014/ on the rig itself. To see it from another machine on your network, add --set http_address=0.0.0.0 to the command — there is no password on it, so only do that on a network you trust.

Overclocking on Linux is privileged. Every clock, power and fan change is a driver write that needs root, so run the miner with sudo when you use the --oc-* flags. Without root the run still mines; each refused knob is named in the log with the reason.

Note

XELIS has no Metal kernel, so on a Mac it mines on the CPU only. The command is the same; the GPU is simply not used.

  1. Download, unpack, clear the quarantine flag

    tar -xzf bzminer_v100.82_macos.tar.gz
    cd bzminer_v100.82_macos
    xattr -dr com.apple.quarantine .

    The build is not signed with an Apple Developer ID, so macOS refuses to open it until the quarantine flag is cleared. That last line does it once, for the whole folder. The archive is Apple Silicon only; it does not run on Intel Macs.

  2. Put your wallet in the launcher

    Open start_xelis.sh in TextEdit or any editor and replace the placeholder wallet.

  3. Run it

    ./start_xelis.sh

    Or written out:

    ./bzminer \
      -a xelis \
      -p stratum+ssl://us.vipor.net:5177 \
      -w xel:YOUR_WALLET \
      --worker rig1
  4. Open the dashboard

    http://127.0.0.1:4014/ in Safari or any browser on the Mac.

On a Mac the GPU is reached through Metal, and only algorithms with a Metal kernel use it: Ergo, KawPow, Ethash, Pearl, Warthog and CryptoNight. XELIS, RandomX and Verus mine on the CPU there. There is no overclocking on macOS.

The clean way is Hive’s custom miner mechanism, which installs the current bzminer straight from the release page and lets you type any algorithm name. The Hive OS and mmpOS guide has the detail and the alternative of updating Hive’s own bzminer entry in place.

  1. Make a flight sheet

    Coin, wallet and pool as usual. For the miner pick Custom, then open Setup Miner Config.

  2. Fill in the custom miner form

    Miner namebzminer_custom
    Installation URLhttps://github.com/bzminer/bzminer/releases/download/v100.82/bzminer_custom-v100.82.tar.gz
    Hash algorithmxelis
    Wallet and worker template%WAL% — just the wallet. Hive passes the rig name separately and bzminer joins the two itself, so a template with a worker in it would name the worker twice.
    Pool URLstratum+ssl://us.vipor.net:5177 — a bare host:port means plain stratum; write stratum+ssl://host:port in full for TLS
    Passx
    Extra config argumentsAny bzminer flag, on one line — overclocks, --devices, --cpu_threads.
  3. Apply it to the rig

    Hive downloads the package on first start. Hashrate, temperatures and shares appear on the Hive dashboard because bzminer serves Hive’s stats format itself on port 4014, so leave the web server on its default port.

mmpOS ships a bzminer miner profile. What it does not ship is the current version, so the profile gets a one-time download script, and any algorithm its own list does not know is reached with --force_algo.

  1. Create a miner profile

    Miner bzminer, the coin or algorithm, your pool and wallet. The rig name becomes the worker name.

  2. Install the current version

    In the profile, under Advanced, paste this into “Initiate command prior to miner launch”. It downloads v100.82 once and exits immediately on every later launch, so it costs nothing per restart. To move to a later release, change the version on the first line.

    export version="v100.82"
    if [ -f "/tmp/bzminer_${version}_linux.tar.gz" ]; then
    exit 0
    else
    cd /tmp; wget https://github.com/bzminer/bzminer/releases/download/${version}/bzminer_${version}_linux.tar.gz; tar -xvf bzminer_${version}_linux.tar.gz; sudo cp -adpR bzminer_${version}_linux/bzminer /opt/mmp/miners/bzminer/
    fi
  3. Name the algorithm if the list lacks it

    If xelis is not among the algorithms mmpOS offers for bzminer, pick any and add --force_algo xelis to the profile’s extra arguments. It overrides whatever the OS wrote into the pool block, which is exactly what it is for.

  4. Assign the profile to the rig

    Stats come from bzminer’s own web port, so keep the web server enabled on 4014.

What you should see

Within a few seconds of starting, the log lists every device it found with both its number and its PCI address, connects to the pool, and prints [dev fee] xelis 1% so the fee is stated before anything is mined. The device table shows one row per GPU and one for the CPU (row c), and accepted lines start arriving as shares are found.

The hashrate is measured, not derived. An older bzminer derived its XELIS figure, and it read high; this build reports what the card actually does, so the same card shows a smaller number for the same work. When comparing versions, compare accepted shares over an hour instead — that is the same unit in both.

The poolhr column is the pool’s credited rate as a percentage of the miner’s own. Expect it to swing over minutes and settle near 100% over hours. The console guide explains every column.

Tuning

xelhash is bound by memory, not by the core. On NVIDIA that means a memory offset is what pays, and the power limit can come down a long way before the hashrate follows it:

./bzminer -a xelis -p stratum+ssl://us.vipor.net:5177 -w xel:YOUR_WALLET \
  --oc-power-limit 160 --oc-memory-clock-offset 1000 \
  --oc-fan-speed "t:60[25-75] tm:80[50-100]"

That fan line holds the core at 60 °C and the memory at 80 °C, whichever needs more fan winning. On Linux these are privileged, so run with sudo. Change one thing at a time and give poolhr an hour to mean something. The overclocking guide covers per-card settings, clock locks, the live hotkeys and what each vendor allows.

On the CPU side, --cpu_threads is the only knob. Leave it on auto unless the machine is a dedicated rig, in which case set it to the full thread count.

Solo mining

Point -p at your own node’s WebSocket endpoint instead of a pool. With a node on the same machine that is:

./bzminer -a xelis -p ws://127.0.0.1:8080 -w xel:YOUR_WALLET

You keep whole blocks and find them at whatever rate your hashrate against the network allows, which for one rig can be a long time between them.

Problems

  • Shares are rejected. It is almost always the wallet. Press u in the console to see exactly what is being sent, and check it is a xel: address with nothing appended.
  • A GPU is listed but never mines. The log says why on its own line: a driver too old for the kernel, or no kernel for that architecture.
  • The machine feels frozen. The CPU half is mining on every thread. Lower --cpu_threads, or press T in the console to take threads away live.
  • Dashboard not reachable from another PC. It listens on 127.0.0.1 only; add --set http_address=0.0.0.0.

More in the troubleshooting guide.