December 18, 2018

1893 words 9 mins read



USB flash drive ISO image for Ethereum, Zcash and Monero mining with NVIDIA graphics cards and Ubuntu GNU/Linux (headless)

repo name Cyclenerd/ethereum_nvidia_miner
repo link
language Shell
size (curr.) 523 kB
stars (curr.) 729
created 2017-06-23
license GNU General Public License v3.0

Ethereum Mining with NVIDIA Graphics Cards and Ubuntu

USB flash drive ISO image for Ethereum mining with NVIDIA graphics cards and Ubuntu GNU/Linux (64-bit Intel/AMD (x86_64)). Other cryptocurrencies, such as Monero or Zcash, can also be mined.


Press the πŸ‘οΈ “Watch” button to get updates. Do not forget the 🌟 “Star” button πŸ˜€

🚨 Use at your own risk. Hope to help you. Do not make me responsible for broken hardware. 🚨


  • This ISO image is based on 🐧 Ubuntu 16.04.3 LTS (Server).
  • KISS, keep it simple, stupid. Only the most necessary included. No πŸ’© bullshit.
  • NVIDIA drivers version 390.25 installed.
  • CUDA 8 (/usr/local/cuda-8.0) and CUDA 9.1 (/usr/local/cuda-9.1) ready to be used.
  • ethminer with the optimized code by David Li (from NVIDIA) already compiled and ready for use.
    • The code is optimized for NVIDIA GTX 1060, can improve NVIDIA GTX 1060 with 2 GPC performance by 15%, and NVIDIA GTX 1060 with 1 GPC performance by more than 30%. Meanwhile, it also increases performance on NVIDIA GTX 1070.
  • Claymore’s dual miner version 10.6, XMR-Stak Monero miner and EWBF’s Zcash miner are also included.
  • Already configured to participate in the ethermine ethereum mining pool.
  • The installation is optimized for operation without monitor (headless).
  • No hard disk drive (HDD/SSD) required. Installation on USB flash drive.
  • Created and tested with NVIDIA GeForce GTX 1060, NVIDIA GeForce GTX 1070 and NVIDIA GTX 1080.

Leave a Tip πŸ™

With this ISO image, you can immediately mine Ethereum (ETH). Do not spend long time searching and researching.

I would be happy about a small donation. Thank you very much.

Currency Address
Ethereum 0xfbbc9f870bccadf8847eba29b0ed3755e30c9f0d
Bitcoin 13fQA3mCQPmnXBDSmfautP4VMq6Sj2GVSA


If you do not trust me and do not want to use the image, you will find all configuration files and scripts in the files folder. You only have to install an Ubuntu Linux with all the drivers and tools yourself.

If you want to get started quickly, simply use the pre-configured ISO image (contains the shell scripts, tools, and all necessary drivers).


Download the ISO image via BitTorrent (ethereum-ubuntu-nvidia-miner_v3.img.7z.torrent). Compressed 1.8GB, unzipped 7.5GB.



It is recommended to test that the image is correct and safe to use. The MD5 calculation gives a checksum, which must equal the MD5 value of a correct ISO image.

Filename MD5sum
ethereum-ubuntu-nvidia-miner_v3.img.7z af0b46286047534035e8834b65692334
ethereum-ubuntu-nvidia-miner_v3.img 2ec9e5f871e6a89355006b1cac534859

More help is available here:


  1. Unzip the 7zip file ethereum-ubuntu-nvidia-miner_v3.img.7z.
  2. Copy the image ethereum-ubuntu-nvidia-miner_v3.img to a at least 8GB USB flash drive.

Larger USB flash drive should also work. I use the “Sandisk 32GB Ultra Fit USB 3.0 Flash Drive”.

The copy can be done with dd. ⚠️ The copy lasts long. Be patient.

How this works exactly is explained to you here:


Use the free and open source software Rufus. Simply select the ISO ethereum-ubuntu-nvidia-miner_v3.img, the USB drive you want to create the bootable Linux onto and click start.

Be sure to select DD mode or the image will be transferred incorrectly.

🍎 macOS

Identify the disk (not partition) of your USB flash drive e.g. disk3:

nils@macbookpro ~ $ diskutil list

Unmount your USB flash drive:

nils@macbookpro ~ $ diskutil unmountDisk /dev/disk3

Copy the image to your USB flash drive:

nils@macbookpro ~ $ sudo dd bs=1m if=Downloads/ethereum-ubuntu-nvidia-miner_v3.img of=/dev/rdisk3

Btw. rdisk3 (with r) not disk3 is not a write error.


Set the primary graphics output to one of your NVIDIA cards. Disable Secure Boot (UEFI) and boot from the USB flash drive.


The network configuration is done by DHCP. Look in your router which IP your miner has.

Connect via SSH with your miner.

nils@macbookpro ~ $ ssh prospector@minerIP

Credentials. Password should be changed (passwd):

  • πŸ‘€ Username: prospector
  • πŸ”‘ Password: m1n1ng


There is an extra program which helps you with the initial setup. Type setup to start it.

prospector@mine ~ $ setup


Go through each step. If you have everything set you should do a reboot.


After a minute uptime, a script (screen) starts automatically in the background, which starts the mining.

prospector@mine ~ $ crontab -l

# run screen after reboot
@reboot sleep 60 && /usr/bin/screen -d -m

Enter mine to get it in the foreground:

prospector@mine ~ $ mine

Use key combination Ctrl + a, and subsequently pressing a key to execute one of the commands given below:

  • n : switches to the next available console
  • p : switches back to the previous console
  • c : creates a new virtual Bash console
  • d : detaches the current screen sessions and brings you back to the normal terminal

htop nvidia-smi etherminer

More help is available here:

The script starts automatically (mine console). If you want to make settings that go beyond the setup program, you need to adjust it. If you want to mine other cryptocurrencies, like Monero or Zcash, you also need to adjust this file.

prospector@mine ~ $ nano -w


To pull the last MH/s out of your cards, you should overclock.

With (nvidia-settings)

Run the to adjust the memory and graphics clock. The settings are lost after a restart. You have to repeat it.

prospector@mine ~ $ nvidia-overclock

For safety I did not add it in the autostart. Sometimes you exaggerate when overclocking, and you’ll be glad if a simple reboot helps.

If you are sure that everything works, you can add it to the autostart. For security, it will start after 10 minutes.

prospector@mine ~ $ crontab -e

# After 10 minutes uptime, '' starts automatically
# Only remove the comment if you are sure that everything works!!!
#@reboot sleep 600 && bash ~/ >/dev/null 2>&1

You should experiment with the values and adjust the values in the script. I wish you success πŸ€“

Why not use nvidia-smi?

nvidia-smi does not work with my cards (NVIDIA GeForce GTX 1060 and 1070).

prospector@mine ~ $ nvidia-smi -i 0 -ac 4004,1987
Setting applications clocks is not supported for GPU 0000:01:00.0.
Treating as warning and moving on.
All done.

No idea if this is a πŸ› bug. Have tried several drivers. Forums are full of bug reports. With nvidia-settings I have no problems.

You can try it with your cards. It should work with Ti models. Here the text from the help:

-ac, --applications-clocks=MEM_CLOCK,GRAPHICS_CLOCK

Specifies maximum <memory,graphics> clocks as a pair (e.g. 2000,800) that defines GPU’s speed while running applications on a GPU.

Other things you should do

Update ethminer Ethereum Miner

Update and recompile ethminer:

prospector@mine ~ $ cd ~/ethereum-mining/ethminer
prospector@mine ethminer $ git pull
prospector@mine ethminer $ cd build/
prospector@mine build $ cmake -D CUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda-9.1 ..
prospector@mine build $ cmake --build . --config release

Update Claymore’s Dual Ethereum Miner

Download the latest version Claymore’s Dual Ethereum miner for Linux and copy it to your USB flash driver. The copy can be done via SCP.

On Windows, you can use FileZilla or WinSCP. On Linux and macOS it works like this:

nils@macbookpro ~ $ scp "Claymore's Dual GPU Miner - LINUX.tar.gz" prospector@minerIP:/home/prospector/

Unpack the tar.gz file into the ~/claymore-dual-miner folder:

prospector@mine ~ $ tar xvfz "Claymore's Dual GPU Miner - LINUX.tar.gz" -C ~/claymore-dual-miner --strip-components=1

Update XMR-Stak Monero Miner

Update and recompile XMR-Stak:

prospector@mine:~ $ cd ~/monero-mining/xmr-stak/
prospector@mine:~/monero-mining/xmr-stak $ git pull
prospector@mine:~/monero-mining/xmr-stak $ nano -w xmrstak/donate-level.hpp # Edit donation fee 
prospector@mine:~/monero-mining/xmr-stak $ cd build/
prospector@mine:~/monero-mining/xmr-stak/build $ cmake -DXMR-STAK_COMPILE=generic -D CUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda-9.1 -DOpenCL_ENABLE=OFF ..
prospector@mine:~/monero-mining/xmr-stak/build $ make install

Select the CPU compute architecture:

  • -DXMR-STAK_COMPILE=generic = the miner can be used on all CPU’s with sse2
  • -DXMR-STAK_COMPILE=native = the miner can be used only on the system where it is compiled but will archive the highest hash rate

Update EWBF’s CUDA Zcash Miner

Download the latest version EWBF’s CUDA Zcash miner for Linux and copy it to your USB flash driver. The copy can be done via SCP.

On Windows, you can use FileZilla or WinSCP. On Linux and macOS it works like this:

nils@macbookpro ~ $ scp "Zec Miner Linux Bin.tar.gz" prospector@minerIP:/home/prospector/

Unpack the tar.gz file into the ~/zcash-mining/ewbf/ folder:

prospector@mine ~ $ tar xvfz "Zec Miner Linux Bin.tar.gz" -C ~/zcash-mining/ewbf/ --strip-components=1

Install ccminer CUDA Miner

Compile ccminer:

prospector@mine:~ $ sudo apt-get install libcurl4-openssl-dev libssl-dev libjansson-dev automake autotools-dev build-essential
prospector@mine:~ $ sudo ln -s /usr/local/cuda-8.0 /usr/local/cuda
prospector@mine:~ $ git clone
prospector@mine:~ $ cd ccminer
prospector@mine:~/ccminer $ git checkout linux
prospector@mine:~/ccminer $ ./
prospector@mine:~/ccminer $ ./ccminer --version


The wpa_supplicant package, which includes the main program wpa_supplicant and the passphrase tool wpa_passphrase are already installed.

This method allows quickly connecting to a wireless network whose SSID is already known, making use of wpa_passphrase, a command line tool which generates the minimal configuration needed:

prospector@mine ~ $ sudo wpa_passphrase "SSID" "WPA2-KEY" > /etc/wpa_supplicant/wpa_supplicant.conf

Test configuration:

prospector@mine ~ $ sudo wpa_supplicant -i wlan0 -D wext -c /etc/wpa_supplicant/wpa_supplicant.conf -d

To enable Wi-Fi on the next reboot, remove the comments in the file /etc/network/interfaces:

prospector@mine ~ $ sudo nano -w /etc/network/interfaces
prospector@mine ~ $ reboot

More help is available here:


Of course, with SSH.


munin and the lighttpd web server are also installed. You can use it to access statistics pages.


Here you can find diagrams of the sensors, etc.



Fail2ban is installed. The program monitors logins via SSH. Too many false logins from an IP and the IP is blocked. At each start (reboot) and block you will receive an e-mail. You should check your e-mails from time to time.

prospector@mine ~ $ mutt

More help is available here:


Start x11vnc server.

prospector@mine ~ $ x11vnc

Enter the IP address and display in VNC Viewer to establish a direct connection. For example:



Help πŸ‘

If you have found a bug (English is not my mother tongue) or have any improvements, send me a pull request.

Commits, Comments & Pull requests

I like to have elementary commits as it is much easier to manage for reviewing and debugging. So please don’t be afraid to make as many commits as needed. Merging many commits is as easy as merging one, if not easier. Pull requests can regroup many commits at once. Just try to explain in the pull comment the ‘‘why’’ I should merge it (if it’s not obvious). Please do not try to summarize several big changes (new features) in one pull.

And a few more things:

  • Variables must be uppercase and must begin with MY_.
  • Functions must be lower case and must begin with my_.
  • Check your shell scripts with ShellCheck before submitting.
  • Please use four spaces to indent.

Known Issues

NVIDIA tools (especially nvidia-smi) seems to be lagging on 7 GPU rigs, crashing the system and/or causing some system instabilities. Issue reproduced on two different 7 GPUs rigs (different motherboard & GPU brands). Six graphics cards work without problems.

NVIDIA GeForce GTX 1050 Ti does not have Performance Level 3 (only Level 2) thus has to be changed (change [3] with [2]).

comments powered by Disqus