Skip to content

MacOS Installation

Joe Futrelle edited this page Aug 21, 2015 · 8 revisions

Prerequisites

PostgreSQL

You will need PostgreSQL so that you can use the database client libraries. You can easily install it using Postgres.app:

http://postgresapp.com/

Python packages

Recent versions of Mac OS come with Python 2.7. You should be able to follow the instructions below to install the additional Python packages required. If you don't have easy_install, or it is not working properly, you can follow the instructions in this Stack Overflow post to solve that problem.

Use easy_install to install the Python package called psycopg2. If you installed PostgreSQL using Postgres.app (e.g., version 9.4), you will need to run the following commands (see this SO post for details on why):

PATH="/Applications/Postgres.app/Contents/Versions/9.4/bin:$PATH"
sudo easy_install psycopg2

If you installed a different version of PostgreSQL than 9.4, substitute that version number into the path in place of "9.4".

If you have already installed PostgreSQL using a package other than Postgres.app, the PATH command may vary. For example the path may look something like this:

/Library/PostgreSQL/9.4/bin

After installing psycopg2 install the other required packages, like this:

sudo easy_install sqlalchemy jinja2

Get the code

To get the code, you will need git. git is included with Apple's Xcode command-line tools. If you have not already installed Xcode, you can get it from the Mac App Store. There are other ways to install it as well; see this page for details.

Now change into a directory of your choosing, and clone the git repository like this:

git clone https://github.com/joefutrelle/domdb.git

This will create a directory called domdb containing the client application. Change to that directory

cd domdb

and follow the configuration instructions in Installation to configure the application for your database.

Clone this wiki locally