This is the first release of NvEZOS v1.0. After tons of feedback from the beta version I put out close to a month ago, I have added features that I believe will make this mining software beneficial to all Nvidia GPU miners. Below are the instructions on how to install NvEZOS, it’s important that you follow them closely for all features to work properly. Enjoy!

The procedure may look long, but it’s really just detailed, install on avg took me 20 minutes from making USB to mining, and this was with 2 USB 2.0 drives, so it could be much faster if you have a USB 3.0 mainboard on your miner!

UPDATE: V1.04 is now available which reverts back to Ubuntu-Gnome 16.04.2 as the base OS. 16.04.3 seemed to introduce several issues for multiple users, thus 16.04.2 seems to be the best way forward. It also reverts to a more manual setup process. All in all, its likely a quicker setup, but will require running one or two commands – it also seems to be MUCH more reliable than the runonce service. If you have been experiencing any issues with v1.03 or earlier, I recommend installing v1.04, if everything is working normally in your environment, there is no need to upgrade as no new functionality has been added.

The github has now also been updated with V1.04. Included is an update script. This can be used to update ANY version of NvEZOS, but keep in mind, settings will not be saved, so please note them before going through the upgrade process. The github README contains the instructions for the update process. Our github is HERE.

You can always view the latest update notes HERE.

Additional user documentation can now be found HERE.

ISO available soon.

Download ISO HERE

MD5 Checksum HERE


  1. Nvidia GPU(s) – None of the overclocking or monitoring functions will work with AMD
  2. At least 2GB Ram
  3. Minimum 12GB root partition (you should be fine with a 16GB flash drive, but 8GB is not enough)
  4. You can install this OS to a USB flash drive you will just need two flash drives, one for the install and one as the destination. Im working on getting a ready to go bootable drive image available, but the size has made it a bit prohibitive for now.


Username – miner

Password – nvezos


  1. Write ISO image to USB drive. I recommend using Rufus for this in Windows ( – you can leave the default options, simply select your drive in the device menu and change “Create a bootable disk using” to “ISO Image” than click on the disk symbol on the right to point it to the iso downloaded above.
  2. When the write begins it will ask you to choose ISO or DD mode, chose ISO.
  3. Once the drive is created, boot your miner from this drive and select the default (Live) option, it may take quite awhile to boot (up to 5 minutes in some cases) – this can be improved by using a USB 3.0 flash drive.
  4. Once in the OS, you need to perform the persistent install, click Activities in the top left, then in the taskbar on the left the top icon should be Install.
  5. This will launch the standard Ubuntu install wizard, On the “Preparing to install” screens be sure to leave Download updates and Install third-party software unchecked.
  6. The easiest installation type to use is Erase disk and install Ubuntu (provided you only have one disk/flash drive other than your USB install drive), otherwise you’ll need to use “Something Else”.
  7. Confirm the disk changes, set your time zone, and setup your user account with password. DO NOT CHECK ENCRYPT HOME FOLDER. Also you must set this user to log in automatically (see note below). This user is seperate from the WebUI user, feel free to make them the same, but the passwords wont be linked.

EXTREMELY IMPORTANT┬áIf you want the overclocking function to work, the user you setup must be set to log-in automatically, this provides an X session for our scripts to bind to. It’s not much of a concern as display output will be disabled anyways after configuration is complete. In addition, as the build has reverted back to using 16.04.2, you may see an “Unexpected error” popup on the desktop during install and first run – this can be ignored.

  1. The actual install process will take a bit longer than the typical Ubuntu install as CUDA, drivers, etc are preloaded in the ISO (saving you time and bandwidth), if an error pops up under the installer, hit continue or ignore it, its an error in a dependency of one of the modules required to build ethminer, Im working on fixing this, but as of this time it doesnt cause any issues, it’s simply an annoyance.
  2. Once the process completes, it should prompt you to reboot, during the reboot (wait for the system to go down completely) youll want to remove the USB install drive.
  3. The OS will now boot into the persistent install – again this first boot will likely take quite awhile (up to 5 min) – where you may see black screen, blinking cursor, etc.
  4. Once on the desktop, hover over activities and type terminal into the search to find the terminal – open it.
  5. First you’ll want to grab your ip type (without the quotes) “hostname -I” then hit enter – this should show your DHCP assigned address.
  6. Type the following command (without the quotes) then hit enter – “sudo chmod +x /nvezos/”
  7. Type the following command (without the quotes) then hit enter – “sudo /nvezos/”
  8. It will prompt you for a password, this is the one you made during setup, type it and hit enter.
  9. Once the setup script completes it will reboot the system after 60 seconds, or at this point you can reboot manually. After reboot the system will become headless and you can access it via a web browser at https://ipaddress and login with the default credentials, username – miner, password – nvezos