Ethereum Builder's Guide

Option 1: Homebrew tap


  • Brew is installed. If not, run:
    ruby -e "$(curl -fsSL"
    and follow the prompts.
brew tap ethereum/ethereum
brew install ethereum

Install the latest develop branch with --devel.

Add --with-gui to brew the mist browser.

Then run mist (GUI) or geth (CLI)

For options and patches, see:

Option 2: Manual installation


  • Go 1.2+ is installed. If not refer to this page.
  • Brew is installed. If not, run ruby -e "$(curl -fsSL" and follow the prompts

Install Qt 5.4.x:

brew install qt5

Now configure some path for go-qml to properly build:

export PKG_CONFIG_PATH=/usr/local/opt/qt5/lib/pkgconfig
export CGO_CPPFLAGS="-I/usr/local/opt/qt5/include/QtCore"
export LD_LIBRARY_PATH=/usr/local/opt/qt5/lib

Compile Mist

go get

This should start Mist and connect you to the Ethereum network. However, if you want a traditional *.app file we'll need to use our build tool.

git clone [email protected]:ethereum/go-build.git
cd go-build/osx && python

This will save a in the osx directory.

Option 3: Building from source easy guide

WARNING: Guide is outdated but remains for references

We now have a simple tutorial to install from source: