sowson / ethminer

Ethereum miner with OpenCL and Stratum support for macOS 15.x only!
GNU General Public License v3.0
13 stars 0 forks source link

ethminer

Build on macOS

git clone https://github.com/sowson/ethminer.git ethminer

cd ethminer

git clone https://github.com/ethereum/cable.git cmake/cable

mkdir build

cd build

cmake ..

make

make install

standard-readme compliant Gitter Releases

Ethereum miner with OpenCL, CUDA and stratum support

Ethminer is an Ethash GPU mining worker: with ethminer you can mine every coin which relies on an Ethash Proof of Work thus including Ethereum, Ethereum Classic, Metaverse, Musicoin, Ellaism, Pirl, Expanse and others. This is the actively maintained version of ethminer. It originates from cpp-ethereum project (where GPU mining has been discontinued) and builds on the improvements made in Genoil's fork. See FAQ for more details.

Features

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.

Builds Release Date
Last GitHub release GitHub Release Date
Stable GitHub release GitHub Release Date

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

Examples connecting to pools

Check our samples to see how to connect to different pools.

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 the CUDA version you use, choose Artifacts then download the zip file.

Building from source

See docs/BUILD.md for build/compilation details.

Maintainers & Authors

Gitter

The list of current and past maintainers, authors and contributors to the ethminer project. Ordered alphabetically. Contributors statistics since 2015-08-20.

Name Contact
Andrea Lanfranchi @AndreaLanfranchi ETH: 0xa7e593bde6b5900262cf94e4d75fb040f7ff4727
EoD @EoD
Genoil @Genoil
goobur @goobur
Marius van der Wijden @MariusVanDerWijden
Paweł Bylica @chfast
Philipp Andreas @smurfy
Stefan Oberhumer @StefanOberhumer

Contribute

Gitter

To meet the community, ask general questions and chat about ethminer join the ethminer channel on Gitter.

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

License

Licensed under the GNU General Public License, Version 3.

F.A.Q

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.

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 4GB GPU?

Not really, your VRAM must be above the DAG size (Currently about 4.023 GB.) to get best performance. Without it severe hash loss will occur.

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.

What does the --cuda-parallel-hash flag do?

@davilizh made improvements to the CUDA kernel hashing process and added this flag to allow changing the number of tasks it runs in parallel. These improvements were optimised for GTX 1060 GPUs which saw a large increase in hashrate, GTX 1070 and GTX 1080/Ti GPUs saw some, but less, improvement. The default value is 4 (which does not need to be set with the flag) and in most cases this will provide the best performance.

What is ethminer's relationship with Genoil's fork?

Genoil's fork was the original source of this version, but as Genoil is no longer consistently maintaining that fork it became almost impossible for developers to get new code merged there. In the interests of progressing development without waiting for reviews this fork should be considered the active one and Genoil's as legacy code.

Can I CPU Mine?

No, use geth, the go program made for ethereum by ethereum.

CUDA GPU order changes sometimes. What can I do?

There is an environment var CUDA_DEVICE_ORDER which tells the Nvidia CUDA driver how to enumerates the graphic cards. The following values are valid:

To prevent some unwanted changes in the order of your CUDA devices you might set the environment variable to PCI_BUS_ID. This can be done with one of the 2 ways:

Insufficient CUDA driver

Error: Insufficient CUDA driver: 9010

You have to upgrade your Nvidia drivers. On Linux, install nvidia-396 package or newer.