Version 10 (modified by Gavin Treadgold, 10 years ago) ( diff )

added additional install info for command line tools

Installation Guidelines: Mac - Developer (Manual)

Install Apple 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 ("UNIX Development", plus "System Tools" in newer 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 GIS tools

For some GIS features of Eden (e.g. if you would rather use PostgreSQL with PostGIS instead of MySQL) install the GDAL framework

Install Python

If you are currently running the default Python installation, several dependencies will fail to install. Be sure to install a version of Python, from Python Homepage, e.g.

Install Python packages

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 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

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, 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.)


  • 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)

Install GEOS

You will also need to install the "geos" package from MacPorts, or Homebrew, without this, an exception occurs when starting Sahana Eden

sudo port install geos


Install Web2Py & Sahana:

Note: See TracWiki for help on using the wiki.