Usage
Mine away!
To start miniZ Equihash miner on Linux: open a console window and type
|
1 |
./miniZ --url=username@server:port |
On Windows: start CMD shell (CMD.exe) and type
|
1 |
miniZ.exe --url=username@server:port |
- Substitute username by your pool username. This is usually your wallet address, depends on the pool.
- Substitute server:port by the pool address and the port number.
- Ex. to mine BTG in 2miners:
[email protected]:4040 - Ex. to mine BTG in suprnova:
[email protected]:8866
- Ex. to mine BTG in 2miners:
Usage examples are written for Linux console, in case you’re using Windows shell just substitute ./miniZ by miniZ.exe .
Help
For details on parameters
|
1 |
./miniZ --help |
|
1 |
./miniZ -h |
Command line arguments
| Arguments | Description | Default | Required |
|---|---|---|---|
| General information | |||
| --version (-v) | Print miniZ version information. | - | N |
| --help (-h) | List these command line arguments on screen. | - | - |
| --cuda-info (-ci) | List all available CUDA devices (GPUs) information on screen. | - | N |
| Device options | |||
| --cuda-devices= (-cd) [devices] | Enable CUDA mining on specific devices. If none is specified, miniZ will mine with all available devices (comma separated). Ex. --cuda-devices=0,2,3 or --cd=0,2,3 Also compatible, space separated: --cuda-devices 0 2 3 or --cd 0 2 3 | All available | N |
| --cuda-exclude= (-cde) [devices] | Include all devices except the ones specified (comma separated). Ex. --cuda-exclude=1,3,5 or --cde=1,3,5 Also compatible, space separated: --cuda-exclude 1 3 5 or --cde 1 3 5 | - | N |
| --tempunits=[Temperature unit] | Shows temperature in Celsius (C) or Fahrenheit (F). | C | N |
| --templimit=[Temperature value] | Temperature limit at which mining will suspend for one minute. You can specify temperature in Celsius (C) or Fahrenheit (F). | 90 C / 194 F | N |
| Mining pool connection | |||
| --user= (-u) [username] | Username | - | [deprecated] |
| --worker=[worker] | Alternate way to specify worker. | - | - |
| --server= (-l) [[ssl://]server] | Server address | - | [deprecated] |
| --port= [port] | Port number | - | [deprecated] |
| --url= [[ssl://][email protected]:port] | Alternative way to specify all the three previous arguments: [ssl://]username + server + port | - | Y |
| --pass= (-p) [password] | Password | x | N |
| --cleanjobs | Only accept clean jobs. Can cause invalid shares. Use with care. | - | - |
| --jobtimeout=[n] | If miner does not get new jobs for n time (in seconds), it will disconnect from pool. Decreasing n below 80-100 may cause instabilities, depends also on the pool. | 300 | - |
| --stale=[stale=100] | Stale>100 improves performance slightly, stale<100 reduces #stale shares. | 100 | - |
| --retries=[n] | Number of times to retry connection to an unavailable pool. | 3 | - |
| --retrydelay=[n] | Time between consecutive reconnections to an unvailable pool. | 5 | - |
| --quit-disconnect | Quit on disconnection from pool or file `quit-miniZ` is detected. | - | - |
| Algorithm options | |||
| --par=[parameters] | Equihash algorithm parameters. Ex. --par=144,5 | 144,5 | N |
| --pers= [pers_string] | Coin personalised string. auto for automatic personalization string. Ex.Bitcoin Gold (BTG) --pers=BgoldPoW BitcoinZ (BTCZ) --pers BitcoinZ | BgoldPoW | N |
| --smart-pers | Writing this parameter tells miniZ to use personalization string 'auto' if available, otherwise uses specified pers. Use for compatibility with Mining Rig Rentals. | - | N |
| Display options | |||
| --coolui | Alternative nice look for miniZ. | - | N |
| --nocolor | Remove colors from console. | - | N |
| --color | Keep colors on logfile. | No colors | N |
| --gpu-line | Lists each GPU information in a different line (default output if running > 1 GPUs). Omission will print information in the same line. | - | N |
| --pci-order | Display GPU pci bus numbers instead of sequential. | - | N |
| --telemetry= (-a) [port] | Local API port (to disable set port to 0). Ex. --telemetry=0.0.0.0:20000 | 20000 | N |
| --show-solratio | Show number of solutions per iteration. | - | N |
| --show-pers | Show personalization string. Good for pers. string check. | - | N |
| --latency | Show current server ping latency. | - | N |
| --shares-detail | Show accepted/stale/rejected shares per GPU, instead of accepted share efficiency. | Accepted share efficiency | N |
| --all-shares | Include fee shares on statistics. | - | N |
| --show-server | Shows the server address. | - | |
| --show-shares | Shows submitted shares/stale/rejected shares. | - | N |
| --server-share | Lists percentage time connected to each server (yours and fee's) | - | N |
| --extra | Alternative way to specify all the three previous arguments. This will show: shares + server address + server share | - | N |
| --localtime=[n] | [0-4] will show runtime or formatted local time. [11-14] will show both runtime and formatted local time. | Run time | - |
| --show-mode | Shows kernel mode number running on each GPU. | - | - |
| Logging options | |||
| --csv=[filename] | Save all statistics to [filename] in CSV format. | - | N |
| --log | Copy program output to miniZ.log | miniZ.log | N |
| --logfile [filename] | Copy program output to filename | - | N |
| --log-period | Define the time interval (in seconds) between periodic writes to the log/output file. | 10 s | N |
| --log-delay | Define the time to wait (in seconds) before starting periodic writes to the log/output file. | 10 s | N |
| --stat-int=[interval] | Interval [seconds] while reading statistics. | 10 s | N |
| --nonvml | Disable GPU monitoring. | - | N |
| --forcenvml | Force GPU monitoring. | - | N |
| Configuration file | |||
| --read-config [filename] | Read configuration from [filename] (default: miniZ.conf). If not specified, miniZ will always run miniZ-master.conf if this file exists. | miniZ.conf | N |
| --write-config [filename] | Write configuration to [filename] (default: miniZ.conf). | miniZ.conf | N |
| Optimisation options | |||
| --oc1 | Combine this option with power saving to mine faster. Can be defined per GPU. Ex. --oc1=1,4 applies oc1 to GPU 1 and to GPU 4 (numbering as in --cuda-devices). If GPU is not specified applies to all GPUs. | - | N |
| --oc2 | Combine this option with OC to mine faster. Can be defined per GPU. Ex. --oc2=2,4 applies oc2 to GPU 2 and to GPU 4 (numbering as in --cuda-devices). If GPU is not specified applies to all GPUs. | - | N |
| --ocX | miniZ will try to find the best kernel for your GPU. | - | N |
| --ocXsamples=[samples] | Number of samples for ocX, more [samples]->more accuracy (default 300). | 300 | N |
| --ocXreset | Reset GPU statistics when ocX is finished. | - | N |
| --list-modes | List available kernels for each GPU at the beginning. | - | N |
| --mode[GPU]=[kernel] | Forces [GPU] to run [kernel]. | - | N |
| --f11=[n] | This option is used for tuning the algos, and debugging purposes. | - | [deprecated] |
| --mt-auto | Use automatic memory timings (sudo required) | - | N |
| --mt-dump | Dump memory timings in use (sudo required). | - | N |
| --mt=[timings] [16-32].[3-9] | Apply list of memory timings per GPU. Always specify the timing pair, with the values separated by . [dot] such as 16.5. Ex. --mt=16.4,0,20.5 The 0 means no timings should be applied.(sudo required) | - | N |
| --intensity= [number 1-100] | Specify miner running intensity, per GPU. Ex. --intensity=20,40 applies --intensity=20 to the first selcted GPU and --intensity=40 to the second selected GPU. | 100 | N |
| Other | |||
| --fee-time=[n] | Minimum continuous time (in seconds, n>20) to mine fee. Higher values decrease the number of switches between miner/user and fee mining servers. | 20 s | N |
| --donate= [n] | Adds n% to 2% fee. Thank you for your donation! 🙂 | - | N |
Examples
To mine BTG with all GPUs, in btgpool, port 3857, wallet address GdkQGJmbdvx2UBRhomUAXwdUbKJySXzubo, worker worker, no password. Note that for BTG there is no need to specify the algorithm parameters:
|
1 |
./miniZ --url=GdkQGJmbdvx2UBRhomUAXwdUbKJySXzubo.worker@eu.btgpool.pro:3857 |
To mine BTG with GPU 0 and 2, in 2miners, port 4040, wallet address GdkQGJmbdvx2UBRhomUAXwdUbKJySXzubo, worker worker:
|
1 |
./miniZ -cd 0 2 --url=GdkQGJmbdvx2UBRhomUAXwdUbKJySXzubo.worker@btg.2miners.com:4040 |
Same as previous, but specifying a second pool+user+port:
|
1 |
./miniZ -cd 0 2 --url=GdkQGJmbdvx2UBRhomUAXwdUbKJySXzubo.worker@btg.2miners.com:4040 --url=myuser.worker@btg.suprnova.cc:8866 |
To mine BTCZ with GPU 0, 1 and 2, in equipool, with SSL, worker worker:
|
1 |
./miniZ -cd 0 1 2 --url=ssl://YourWalletAddress.worker@mine-btcz-euro.equipool.1ds.us:50066 |
Same as previous but with alternative command line arguments:
|
1 |
./miniZ -cd 0 1 2 --user YourWalletAddress.worker --server ssl://mine-btcz-euro.equipool.1ds.us --port 50066 |
To mine BTCZ in 2miners, port 2020, and BTG in suprnova, port 8817, with GPU 0 and 2:
|
1 |
./miniZ -cd 0 2 --url=t1appvYQcvaiLh9k45btNKXPognVhYcM1Br.worker@btcz.2miners.com:2020 --url=myuser.worker@btg.suprnova.cc:8866 |
To mine MNX with GPU 2, choosing two pools – solopool, port 2020, and minexpool, port 3333:
|
1 |
./miniZ -cd 2 --par=96,5 --url=YourWalletAddress.worker@s4.solopool.org:8002 --url=YourWalletAddress.worker@eu.minexpool.eu:3333 |
Console output
Because it is important to have feedback while miniZ is running, some information (speed, GPU temperature…) will be presented on the console window1.
First, you’ll see a header listing the command line parameter values. Although miniZ will give warning for common mistakes, it is good to confirm that all is correct.
After the header the following information will show:
If ––extra was specified in the command line, you will see the following instead since more information will be added to the line info:
If ––gpu-line was specified you will see the GPU information displayed per line (this shows core and memory clocks). In the following example the ––latency option was additionally used:
As stated elsewhere, the fee is set up to 2% of the total mining time. When looking at server share percentage values it is possible that your pool share is >98%, this means that the program will soon switch for the fee pool. Similarly, when the fee pool share is >2% the program will soon switch for your pool. In the beginning these percentage values will show less balanced, this is only because the total running time is, at that moment, too short (Ex. 10 s is about 8% of a running time of 2 min).
Check the command line arguments table for more information about the display options.
For additional output information check the Telemetry page here.
1On Windows: If you are not using Windows 10, the console may not show the colors properly. However, you can use another console. We tried ConEmu terminal emulator and it worked fine. There are others available, which should also work OK.