Ethereum Builder's Guide

Option 1: Homebrew tap

Assumptions:

  • Brew is installed. If not, run:
    ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
    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: https://github.com/ethereum/homebrew-ethereum

Option 2: Manual installation

Assumptions:

  • Go 1.2+ is installed. If not refer to this page.
  • Brew is installed. If not, run ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)" 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 github.com/ethereum/go-ethereum/cmd/mist

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 git@github.com:ethereum/go-build.git
cd go-build/osx && python build.py

This will save a Mist.app 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: http://forum.ethereum.org/discussion/905/go-ethereum-cli-ethereal-simple-build-guide-for-osx