explaingit

ethereum-mining/ethminer

5,949C++Audience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

Ethminer is a GPU cryptocurrency miner for the Ethash proof-of-work algorithm used by Ethereum Classic and similar coins, supporting both Nvidia and AMD graphics cards via CUDA and OpenCL.

Mindmap

mindmap
  root((ethminer))
    What it does
      GPU crypto mining
      Ethash algorithm
      Pool connection
    GPU support
      Nvidia via CUDA
      AMD via OpenCL
    Features
      Pool failover
      DAG generation
      Exit codes
    Install
      Pre-built binaries
      Build from source
      Windows and Linux
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Mine Ethereum Classic or other Ethash-based coins using your Nvidia or AMD GPU connected to a mining pool

USE CASE 2

Configure automatic failover to a backup mining pool if the primary pool connection drops

USE CASE 3

Download a pre-built executable and start mining in minutes without compiling from source

USE CASE 4

Build ethminer from source to customize mining parameters for a specific coin or pool configuration

Tech stack

C++CUDAOpenCL

Getting it running

Difficulty · moderate Time to first run · 30min

Ethereum mainnet switched to proof-of-stake in 2022, ethminer no longer applies to ETH, GPUs with less than 4GB VRAM have severe performance degradation due to DAG size.

GPL v3, free to use and modify, but any changes you distribute must also be released under GPL v3.

In plain English

Ethminer is a program that uses a computer's graphics card to mine cryptocurrency. Specifically, it is built around the Ethash algorithm, which was the proof-of-work system used by Ethereum and several similar coins including Ethereum Classic, Musicoin, and Ellaism. The project originated from the official Ethereum C++ client but was picked up and extended by independent developers after GPU mining support was removed from the original project. The software works by connecting your GPU to a mining pool, which is a group of computers that combine their computing power to find new blocks and share the rewards. You point ethminer at a pool address, provide your wallet address, and it runs continuously in the background generating hashes. It supports both AMD graphics cards (via OpenCL) and Nvidia graphics cards (via CUDA), and it can fail over to a backup pool if the primary connection drops. Installation is straightforward: download the correct pre-built executable for your operating system from the releases page, unzip it, and run it from the command line. There is no graphical interface. Building from source is also documented for users who need a customized version. The FAQ section addresses common performance questions. Nvidia GTX 1080 cards can be slower than GTX 1070 cards because of the specific type of memory they use. Graphics cards with 4GB of video memory struggle because the mining dataset (called the DAG) has grown larger than 4GB, causing a significant drop in performance. Windows 10 users with Nvidia cards sometimes see lower speeds than Linux users due to differences in how the Windows driver model handles GPU memory. Ethminer is licensed under the GNU General Public License version 3. Note that Ethereum itself switched from proof-of-work to proof-of-stake in September 2022, so this tool no longer has a use for mining Ethereum on the main network. It may still apply to coins that kept the Ethash algorithm.

Copy-paste prompts

Prompt 1
Show me the ethminer command to connect my Nvidia GPU to an Ethereum Classic mining pool with a failover backup pool address configured
Prompt 2
What ethminer settings maximize hashrate on an AMD RX 580 on Linux for Ethash mining?
Prompt 3
Why is my Nvidia GTX 1080 getting lower hashrate than a GTX 1070 on Ethash, and is there any workaround?
Prompt 4
How do I set up ethminer with CUDA on Windows 10, what drivers and environment do I need to install first?
Prompt 5
Which Ethash-based coins still use proof-of-work now that Ethereum switched to proof-of-stake, and can ethminer mine them?
Open on GitHub → Explain another repo

← ethereum-mining on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.