Compiling on macOS using Homebrew

From GRASS-Wiki
Revision as of 09:04, 18 November 2019 by Rkrug (talk | contribs) (Removed svn installation as it does not work anymore.)
Jump to navigation Jump to search

What is homebrew and why use it

To quote from their website:

Homebrew is the missing package manager for OS X:

  • easy to install
  • does not need administrator privileges
  • installs packages to their own directory and then symlinks their files into /usr/local

For further information to install it and how to use it, see the Homebrew website and the Wiki.

The formulas to install programs are called recipes and they make it possible to install several version of the same program (as well as HEAD of different Version Control Systems) at the same time which can then be symlinked. This makes it perfect for the purpose of installing the master branch of GRASS GIS for testing purposes.


There is an osgeo4mac which contains recipes for GRASS GIS 7.x and other GIS tools - highly recommendable tap!


Just run

     brew tap osgeo/osgeo4mac

and then

     brew install osgeo-grass

Easy, isn't it?

You can also install via URL:

     brew install


  • by running (change '7x' to the current version)
     brew test -v grass-7x

you can run GRASS GIS tests but they are not implemented as they should be - work in progress.


If you have a 3rd party Python installed, and/or Python 3, you need to remove it from your path for the installation. Once installed, GRASS will run even if the primary Python is, for example, Anaconda Python 3.

Display the current path, and remove any folders or directories that provide access to the non-system python2.7:

   echo $PATH
   #  ~/local/anaconda/bin:/Users/MyName/bin:/usr/local/bin:/usr/bin/sbin

Reset path


Set GRASS python

   export GRASS_PYTHON=/System/Library/Frameworks/Python.framework/Versions/Current/bin/pythonw

Install packages with Brew

   brew tap osgeo/osgeo4mac
   brew install netcdf
   brew install gdal2 --with-complete --with-unsupported
   export GDAL_DATA=/usr/local/opt/gdal2/share/gdal/   
   # Also add the above line to ~/.bash_profile, ~/.bashrc, or some other login script
   brew install grass7 --with-netcdf
   brew install gdal2-grass7


  1. PATH adjustments are only needed during installation. After installation, the PATH can return to its default value and GRASS works fine.
  2. There may be other brew dependencies that were installed previously and therefore not listed here.

GRASS GIS 7.0.x for El Capitan without disabling SIP

The new homebrew recipe for GRASS 7.0 does install on El Capitan with SIP enabled! This is thanks to Larry Shaffer. See

The recipe is part of the Homebrew-osgeo4mac tap, see

for info on how to use them.