Version 28 (modified by Pat Tressel, 11 years ago) ( diff )


Installation Guidelines: Mac - Developer (Manual)

Install Apple Xcode Developer Tools

You will need Apple's Xcode Developer Tools (version 4.1 or later for Lion, 3.2 or later for Snow Leopard, or 3.1 or later for Leopard), found at the Apple Developer Connection site, on your Mac OS X installation CDs/DVD, or in the Mac App Store. Using the latest available version that will run on your OS is highly recommended. Ensure that the optional components for command line development are installed ("Command Line Tools" in the newest, "UNIX Development", plus "System Tools" in less-new versions, or "Command Line Support" in older ones).

Install Command Line Tools

The Xcode Command Line Tools need to be installed after Xcode has been installed. To install the Command Line Tools:

  1. Open Xcode
  2. Open Xcode -> Preferences, and select the Download tab.
  3. Under the Components tab, click the Install button next to Command Line Tools. Note that this may require you to create a developer account with Apple to complete the download.

Caution: The Xcode download is over 3GB.

Install MacPorts

The MacPorts Project is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading either command-line, X11 or Aqua based open-source software on the Mac OS X operating system. Installing MacPorts will make installing some of the dependencies easier.

Before installing any new software with MacPorts, make sure to run the following command to ensure that the Portfiles are up to date.

sudo port -v selfupdate

Note, if you get this error...

Warning: xcodebuild exists but failed to execute

... when running port, and have had old versions of Xcode that used the \Developer directory, you may need to run this command to update the Xcode directory.

sudo /usr/bin/xcode-select -switch /Applications/

Install GIS tools

For some GIS features of Eden (e.g. if you would rather use PostgreSQL with PostGIS instead of MySQL) you are required to install the GDAL framework. GEOS is also required, and is a dependency of shapely.

MacPorts Install (recommended)

sudo port install gdal geos

Install Python

The current preferred version for Python for developers is version 2.7. If you are running the default Apple Python installation, several dependencies will fail to install. Be sure to install a version of Python, from the Python Website, or using MacPorts.

MacPorts Install (recommended)

sudo port install python27; sudo port select --set python python27

Install Python packages

MacPorts install (recommended)

sudo port install py27-lxml py27-shapely py27-reportlab py27-xlrd py27-xlwt py-serial py27-tweepy py27-dateutil py27-pil

EasyInstall You can use easy_install or pip for these installations. Be sure to include the "export" line, otherwise these will fail to install because they build for powerPC by default.

export ARCHFLAGS="-arch i386 -arch x86_64" STATIC_DEPS=true 
sudo easy_install python-dateutil
sudo easy_install lxml
sudo easy_install shapely
sudo easy_install reportlab
sudo easy_install xlrd
sudo easy_install xlwt
sudo easy_install pyserial
sudo easy_install tweepy
sudo easy_install pil

Install PostgreSQL + PostGIS extensions

If you want to use PostgreSQL - PostGIS (for which you will need GDAL, above):

  • Install the one clickInstaller sponsored by EnterpriseDB PostgreSQL and select also installation of PostGIS, following this post
  • Please note - If you are installing on Mac OSX Lion, and you encounter errors upon installing the Postgresql through EnterpriseDB version specified in the above link, you could go to this link and download EnterpriseDB Postgresql 9.3.1
  • Install the Python database driver (substitute your path for PostgreSQL):
    sudo easy_install pip
    PATH=$PATH:/Library/PostgreSQL/8.4/bin/ sudo pip install psycopg2
    defaults write Prefer-32-Bit -bool yes
    (Without the last Web2py will not be able to find the PostgreSQL driver.)

Install Git

Check whether you already have git installed by:

which git

If not then...

MacPorts Install (recommended)

sudo port install git-core +doc +gitweb


  • lxml can give trouble on OS X. Try:
    • STATIC_DEPS=true sudo easy_install lxml (adapted from this blog post)
    • remove other libxml2 versions, such as may have been installed by fink or MacPorts - ONLY works in unmodified Python setup. In case you have modified your Python you must link some how the python directory with /frameworks/python otherwise lxml will not being found(not tested)


Configure git; install Web2Py and Sahana Eden:

Note: See TracWiki for help on using the wiki.