Homebrew Tap for Ethereum
Clone or download
karalabe Merge pull request #205 from karalabe/geth-1.8.21
Update go-ethereum to v1.8.21
Latest commit 2d4ea6b Jan 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md Update README to add tap-pin info Oct 18, 2018
cpp-ethereum.rb Build aleth 1.4.0rc5 by default (unless --devel is selected) Aug 30, 2018
ethereum.rb Update go-ethereum to v1.8.21 Jan 15, 2019
solidity.rb Version 0.5.2 Dec 19, 2018



Homebrew Tap for Ethereum

Important note: reporting issues with any of these brews should be done at their respective repositories (Go client, C++ client and Solidity).


brew tap ethereum/ethereum

Go client

brew install ethereum

C++ client

brew install cpp-ethereum


brew install solidity


Go client


C++ client





Get the latest development version with the --devel flag. Use --build-from-source if you don't want a pre-built bottle. Alternatively you can use the --successful flag (cpp-ethereum only, see important note below) or any other available options.

C++ client

brew reinstall cpp-ethereum --devel

For the latest successful build on develop (last successful build from cpt-obvious):

brew reinstall cpp-ethereum --devel --successful

Important note when using --successful

If you get an error looking like this:

==> Cloning https://github.com/ethereum/cpp-ethereum.git
Updating /Library/Caches/Homebrew/ethereum--git
fatal: reference is not a tree: <latest commit hash>
Error: Failed to download resource "ethereum"
Failure while executing: git checkout -q -f

Either try brew fetch cpp-ethereum --devel or simply delete the cache with rm -rf /Library/Caches/Homebrew/cpp-ethereum--git

Go client

brew reinstall ethereum --devel

Current branches


  • --devel is on develop branch
  • normal install is on master branch


  • --devel is on develop
  • normal install is on master branch


brew update && brew upgrade

Minor updates

Go client

brew update && brew reinstall ethereum

C++ client

brew update && brew reinstall cpp-ethereum


List available versions with:

ls -l /usr/local/Cellar/ethereum
ls -l /usr/local/Cellar/cpp-ethereum

If you have other versions installed, you can switch with:

brew switch ethereum <version>

Or follow this StackOverflow answer

These brews can be installed via the raw GitHub URLs, or by cloning this repository locally with brew tap ethereum/ethereum. You can also install binary bottles directly with brew install <bottle_url>, see cpt-obvious for previous builds.


  • Use --verbose to get more info while installing.
  • Make sure to update XCode and the command line tools.
  • Run brew update and brew upgrade
  • Fix what the brew doctor says.
  • Reinstall dependencies: brew reinstall boost --c++11 --with-python
  • Make changes to /usr/local/Library/Taps/ethereum/homebrew-ethereum/ethereum.rb
  • Reinstall with brew reinstall ethereum.rb (send a pull request!)
  • Take a walk

Note that the ethereum keg exists in homebrew-core. It's not always up to date in homebrew-core and you might want to prioritise the version from this tap. To do this, you can pin this tap by running the following command:

brew tap-pin ethereum/ethereum


First cd /Library/Caches/Homebrew/ethereum--git/ and make your changes. Then git diff > shiny.patch, copy/paste the content of your patch under __END__ of ethereum.rb and replace the def patches block with:

def patches

If you want to submit your change, save your patch in a gist, add your option 'shiny-option', 'Shiny description' and the URL to your gist in the patches block and submit a pull request. Make sure to send a pull request to Ethereum also!