Ethereum miner with OpenCL, CUDA and stratum support
The ethminer is an Ethereum GPU mining worker. It origins in cpp-ethereum project (where GPU mining has been discontinued). Then hugely improved in Genoil's fork.
- OpenCL mining
- Nvidia CUDA mining
- realistic benchmarking against arbitrary epoch/DAG/blocknumber
- on-GPU DAG generation (no more DAG files on disk)
- stratum mining without proxy
- OpenCL devices picking
- farm failover (getwork + stratum)
Standalone executables for Linux, macOS and Windows are provided in the Releases section. Download an archive for your operating system and unpack the content to a place accessible from command line. The ethminer is ready to go.
The ethminer is a command line program. This means you launch it either from a Windows command prompt or Linux console, or create shortcuts to predefined command lines using a Linux Bash script or Windows batch/cmd file. For a full list of available command, please run
ethminer --help| CI | OS | Status | Development builds |
|---|---|---|---|
| Travis CI | Linux, macOS |  |
✗ No build artifacts, Amazon S3 is needed for this |
| AppVeyor | Windows |  |
✓ Build artifacts available for all PRs and branches |
The AppVeyor system automatically builds a Windows .exe for every commit. The latest version is always available on the landing page or you can browse the history to access previous builds.
To download the .exe on a build under 'JOB NAME' select 'Configuration: Release', choose 'ARTIFACTS' then download the zip file.
This project uses CMake and Hunter package manager.
-
Create a build directory.
mkdir build; cd build
-
Configure the project with CMake. Check out additional configuration options.
cmake ..
-
Build the project using CMake Build Tool Mode. This is a portable variant of
make.cmake --build . -
(Optional, Linux only) Install the built executable.
sudo make install
Pass these options to CMake configuration command, e.g.
cmake .. -DETHASHCUDA=ON -DETHASHCL=OFF-DETHASHCL=ON- enable OpenCL mining,ONby default,-DETHASHCUDA=ON- enable CUDA mining,OFFby default,-DETHSTRATUM=ON- build with Stratum protocol support,ONby default.
- Paweł Bylica @chfast
To meet the community join the ethminer channel on Gitter.
All bug reports, pull requests and code reviews are very much welcome.
-
Why is my hashrate with Nvidia cards on Windows 10 so low?
The new WDDM 2.x driver on Windows 10 uses a different way of addressing the GPU. This is good for a lot of things, but not for ETH mining. For Kepler GPUs: I actually don't know. Please let me know what works best for good old Kepler. For Maxwell 1 GPUs: Unfortunately the issue is a bit more serious on the GTX750Ti, already causing suboptimal performance on Win7 and Linux. Apparently about 4MH/s can still be reached on Linux, which, depending on ETH price, could still be profitable, considering the relatively low power draw. For Maxwell 2 GPUs: There is a way of mining ETH at Win7/8/Linux speeds on Win10, by downgrading the GPU driver to a Win7 one (350.12 recommended) and using a build that was created using CUDA 6.5. For Pascal GPUs: You have to use the latest WDDM 2.1 compatible drivers in combination with Windows 10 Anniversary edition in order to get the full potential of your Pascal GPU.
-
Why is a GTX 1080 slower than a GTX 1070?
Because of the GDDR5X memory, which can't be fully utilized for ETH mining (yet).
-
Are AMD cards also affected by slowdowns with increasing DAG size?
Only GCN 1.0 GPUs (78x0, 79x0, 270, 280), but in a different way. You'll see that on each new epoch (30K blocks), the hashrate will go down a little bit.
-
Can I still mine ETH with my 2GB GPU?
No.
-
What are the optimal launch parameters?
The default parameters are fine in most scenario's (CUDA). For OpenCL it varies a bit more. Just play around with the numbers and use powers of 2. GPU's like powers of 2.