How to Setup Eagle Development Environment on Mac OSX

This tutorial is based Mac OS X. It can be used as a reference guide for other OS like Linux or Windows as well. To save your time of jumping back and forth between different web pages, all necessary references will be point out.


  • HomeBrew

Make sure you have HomeBrew installed on your mac. If not, please run:

$ ruby -e "$(curl -fsSL"

you can find more information about HomeBrew at .

  • Scala & SBT

Some core eagle modules are written with scala. To install Scala and SBT, just run:

 $ brew install scala
 $ brew install sbt
  • NPM

Eagle-webservice module uses npm. To install it, run:

 $ brew install npm
  • Apache Maven

Eagle is built with maven:

 $ brew install maven
  • HomeBrew Cask

    • Install HomeBrew Cask:

      $ brew install caskroom/cask/brew-cask
    • Next, install JDK via HomeBrew:

      $ brew cask search java

you will see all available JDK versions and you can install multiple JDK versions in this way. For eagle please choose java7 to install:

 $ brew cask install java7


  • During this writing SBT has issue with JDK 8. This issue has been tested confirmed by using:
  • Java 1.8.0_66
  • Maven 3.3.9
  • Scala 2.11.7
  • Sbt 0.13.9

you can find more information about HomeBrew Cask at

  • Jenv

you can use Jenv to manage installed multiple Java versions. To install it:

$ brew install

and make sure activate it automatically:

$ echo 'eval "$(jenv init -)"' >> ~/.bash_profile


Now let Jenv manage JDK versions (remember In OSX all JVMs are located at /Library/Java/JavaVirtualMachines):

$ jenv add /Library/Java/JavaVirtualMachines/jdk1.8.0_66.jdk/Contents/Home/
$ jenv add /Library/Java/JavaVirtualMachines/jdk1.7.0_80.jdk/Contents/Home/


$ jenv rehash

You can see all managed JDK versions:

$ jenv versions

set global java version:

$ jenv global oracle64-

switch to your eagle home directory and set the local JDK version for eagle:

$ jenv local oracle64-

you can find more information about Jenv at and

How to Build Eagle

Go to Eagle home directory and run:

mvn -DskipTests clean package

That's all. Now you have runnable eagle on your Mac. Have fun. :-)