Usage
Mine away!
To start miniZ Equihash miner on Linux: open a console window and type
./miniZ [email protected]:port
On Windows: start CMD shell (CMD.exe) and type
miniZ.exe [email protected]: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
./miniZ --help
./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 | |||
| --nvidia | Only use NVIDIA GPUs. | - | N |
| --amd | Only use AMD GPUs. | - | N |
| --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] |
| --pass= (-p) [password] | Password | x | N |
| --url= [[ssl://][email protected]:port] | Alternative way to specify all the three previous arguments: [ssl://]username + server + port | - | Y |
| --cleanjobs | Only accept clean jobs. Can cause invalid shares. Use with care. | - | - |
| --stale=[stale=100] | Stale>100 improves performance slightly, stale<100 reduces #stale shares. | 100 | - |
| --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 | - |
| --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. | - | - |
| --socks=[proxy] | SOCKS proxy specification. Format [username:[email protected]]server:port. The prefix username:[email protected] is optional. | - | N |
| --socksdns | Let SOCKS proxy resolve DNS requests. | - | N |
| 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 |
| --nohttpheaders | Remove http headers while using getsat API. | - | 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-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-shares | Shows submitted/stale/rejected shares. | - | N |
| --show-server | Shows the server address. | - | |
| --show-mode | Shows kernel mode number running on each GPU. | - | - |
| --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 |
| 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=[interval] | Define the time interval (in seconds) between periodic writes to the log/output file. | 10 s | N |
| --log-delay=[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 |
| --avg0=[period] | Short term average period (in seconds). | 180 s | N |
| --avg1=[period] | Long term average period (in seconds). | 10800 s | N |
| --protocol-dump | Dump pool stratum communication. | - | 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. Do not use --ocX when mining with RTX 30XX with anti-mining lock. | - | 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=[kernel number] --mode[GPU] [kernel number] | Forces all GPUs to run kernel mode number. Ex: To apply kernel mode 30 to all GPUs use --mode=30. To force a kernel to only one GPU, you will need to specify GPU number. In this case do not use '=' sign. Ex. To apply kernel mode 30 to GPU number 4 use --mode4 30. ( You can check GPU numbers by running miniZ.exe -ci ) More info. see FAQ page. | - | N |
| --tune[GPU] [opts] | Ethash algorithm specific tuning options (from v1.8y4rc2). --tune=iN1dN2 where i stands for intensity and d stands for drag. N1and N2 are numerical values. Ex.: To apply tune to all GPUs, with i=17 and d=57 use: --tune i17d57 . More info. see FAQ page. | ||
| --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 |
| --gpuclock=[gpuclock(MHz)] | Apply list of GPU clocks, works for sm>=7. Use gpuclock=1 for auto. (sudo required) | - | N |
| --memclock=[memclock(MHz)] | Apply list of memory clocks, works for sm>=7. Use memclock=1 for auto. (sudo required) | - | N |
| --power=[power(W)] -pl [power(W)] | Apply list of power limits. (sudo required) | - | N |
| Other | |||
| --dag-fix | Check DAG consistency . | - | N |
| --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:
./miniZ [email protected]:3857
To mine BTG with GPU 0 and 2, in 2miners, port 4040, wallet address GdkQGJmbdvx2UBRhomUAXwdUbKJySXzubo, worker worker:
./miniZ -cd 0 2 [email protected]:4040
Same as previous, but specifying a second pool+user+port:
./miniZ -cd 0 2 [email protected]:4040 [email protected]:8866
To mine BTCZ with GPU 0, 1 and 2, in equipool, with SSL, worker worker:
./miniZ -cd 0 1 2 --url=ssl://[email protected]:50066
Same as previous but with alternative command line arguments:
./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:
./miniZ -cd 0 2 [email protected]m:2020 [email protected]:8866
To mine MNX with GPU 2, choosing two pools – solopool, port 2020, and minexpool, port 3333:
./miniZ -cd 2 --par=96,5 [email protected]:8002 [email protected]: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.