You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Luke Childs 42b8921df4 Enable static keyword in OpenCL 1.1 8 years ago
cmake Replace GCC 4.8 toolchain with GCC 5 8 years ago
ethminer Remove CPU miner leftovers 8 years ago
libdevcore Merge pull request #110 from ethereum-mining/logs 8 years ago
libethash Drop evaluation by full DAG 8 years ago
libethash-cl Enable static keyword in OpenCL 1.1 8 years ago
libethash-cuda CUDA: Add Compute 6.0 architecture 8 years ago
libethcore Remove CPU miner leftovers 8 years ago
libstratum Remove CPU miner leftovers 8 years ago
scripts Travis CI: Speed up 8 years ago
.bumpversion.cfg Bump version: 0.11.0 → 0.12.0.dev0 8 years ago
.gitignore Git ignore CLion default build dirs 8 years ago
.gitmodules Update evmjit submodule url 10 years ago
.travis.yml CI: add release* branches to the whitelist 8 years ago
BuildInfo.h.in Simplify buildinfo generation 8 years ago
CMakeLists.txt Bump version: 0.11.0 → 0.12.0.dev0 8 years ago
GPLV3_LICENSE Wording for MIT license and external contributors 10 years ago
LICENSE typo in LICENSE file name 10 years ago
README.md Add detailed explanation of AppVeyor builds (#120) 8 years ago
appveyor.yml CI: add release* branches to the whitelist 8 years ago

README.md

ethminer

standard-readme compliant Gitter Releases

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.

Features

  • 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)

Table of Contents

Install

Releases

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.

Usage

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

Build

Continuous Integration and development builds

CI OS Status Development builds
Travis CI Linux, macOS Travis CI ✗ No build artifacts, Amazon S3 is needed for this
AppVeyor Windows AppVeyor ✓ 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.

Building from source

This project uses CMake and Hunter package manager.

  1. Create a build directory.

    mkdir build; cd build
    
  2. Configure the project with CMake. Check out additional configuration options.

    cmake ..
    
  3. Build the project using CMake Build Tool Mode. This is a portable variant of make.

    cmake --build .
    
  4. (Optional, Linux only) Install the built executable.

    sudo make install
    

CMake configuration options

Pass these options to CMake configuration command, e.g.

cmake .. -DETHASHCUDA=ON -DETHASHCL=OFF
  • -DETHASHCL=ON - enable OpenCL mining, ON by default,
  • -DETHASHCUDA=ON - enable CUDA mining, OFF by default,
  • -DETHSTRATUM=ON - build with Stratum protocol support, ON by default.

Maintainer

Gitter

Contribute

Gitter

To meet the community join the ethminer channel on Gitter.

All bug reports, pull requests and code reviews are very much welcome.

F.A.Q

  1. 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.

  2. 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).

  3. 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.

  4. Can I still mine ETH with my 2GB GPU?

    No.

  5. 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.