Guide
Start mining
Mine TRAI with a GPU or CPU step by step. Get an address, check your hardware, start the Tenrai Miner on a pool or solo and see that it works.
On this page
tenrai-miner mines TRAI on GPUs, through OpenCL or CUDA, and on CPUs. Each block found pays the block reward plus fees.
What you need
| An address | Any Tenrai address from your wallet. Blocks and pool payouts go there |
|---|---|
tenrai-miner | Part of the Tenrai binaries, see Install. Any miner that supports TenQ and Tenrai's Stratum works as well |
| GPU | 4 GB of video memory or more, and a driver with OpenCL. CUDA is optional, see GPU backends |
| CPU and memory | 2 GiB of free RAM for the TenQ dataset, 2.5 GiB more to prepare the next one ahead |
On Linux the OpenCL loader must be installed as well; on Debian and Ubuntu it is the package ocl-icd-libopencl1.
1. Check the hardware
tenrai-miner --list-devices
tenrai-miner --benchmark--list-devices lists every GPU with its index and backend. --benchmark builds the dataset and measures the hashrate on a synthetic job; stop it with Ctrl+C.
2. Choose how to mine
| Way | Payouts | You run |
|---|---|---|
| Pool | Small, regular payouts, minus the pool fee | The miner |
| Solo on your node | Every block you find, in full | A node and the miner |
| Solo through a bridge | As solo, for several rigs | A node, a bridge and the miners |
Most miners start with a pool. Solo pays every block in full, but with little hashrate the blocks come rarely and irregularly.
3. Start the miner
On a pool:
tenrai-miner -a <your address> --stratum stratum+tls://pool.example.org:28741 -w rig1 --poolSolo, with a synced node on the same machine:
tenrai-miner -a <your address>The address is the only thing the miner needs; the node, the ports, the devices and the dashboard have defaults. Started without an address, it asks for one and offers to save it, so the next start is just tenrai-miner.
| Option | |
|---|---|
-a | Your address |
--stratum | The pool's URL, from the pool's website |
-w | A name for this rig, shown on the pool's website |
--pool | Required for pools. Without it the miner refuses work that pays another address than -a |
The first start builds the 2 GiB TenQ dataset on the CPU, about a minute on a six-core desktop CPU. The dataset changes once per epoch, every 34,560 cuts or about a day. By default the next one is built ahead in the background, so mining does not pause.
The miner uses all GPUs, on CUDA or OpenCL whichever the card runs, and two CPU threads, so the machine stays usable. --threads all puts the other CPU threads to work as well, less the one or two that feed the GPUs. Miner options shows how to pick devices, switch the GPU backend or set a temperature limit.
4. Check that it works
The log shows a line every 5 seconds when shares or blocks went out, with accepted, rejected and stale counts, and a table of all devices every 30 seconds.
| Where | What |
|---|---|
http://127.0.0.1:28770/ | Dashboard with charts |
http://127.0.0.1:28770/v1/stats | Hashrate, shares, blocks and every device as JSON |
| The pool's website | Your address: hashrate, balance and payouts |
| An explorer, such as the Tenrai Explorer | Your address: incoming rewards and payouts |
Rejected shares point to a wrong pool URL, a missing --pool or a GPU problem. Troubleshooting lists the usual causes.
Run it permanently
The first start creates tenrai-miner.json next to the program with the default settings, and an address typed at the miner's question is saved there. Set your options in it and start the miner without arguments:
{
"mining-address": "trai1...",
"stratum": ["stratum+tls://pool.example.org:28741"],
"worker": "rig1",
"pool": true
}tenrai-minerFor HiveOS, see HiveOS.