Permalink
Browse files

Add Mac OS X installation instructions.

  • Loading branch information...
juliaogris committed Jan 8, 2013
1 parent 6abae3b commit f93d7fe1f5afe5ba757328e7d0ca1a5cd9573043
Showing with 34 additions and 1 deletion.
  1. +34 −1 INSTALL.md
View
@@ -9,7 +9,7 @@ You will be completing the following steps:
4. Run the installation script to complete configuration
5. Run the server
-Jump to below for [Windows installation instructions](#installing-on-windows).
+Jump to below for [Windows installation instructions](#installing-on-windows) or [Mac OS X installation instructions](#installing-on-mac-os-x).
Installing on Linux
===
@@ -87,6 +87,39 @@ If at any point you see a "Windows Security Alert" [warning about Windows Firewa
The local KA Lite website should now be accessible at [http://127.0.0.1:8008/](http://127.0.0.1:8008/) (replace 127.0.0.1 with your computer's external ip address or domain to access it from another connected computer).
+Installing on Mac OS X
+===
+
+### 1. Install Python
+
+Python comes pre-installed on Mac OS X, but due to Apple's release cycle, it's often one or even two years old. To check that you have got a usable version, run `python -V` from the command line (in Terminal from Applications/Utilities), and ensure that the version number starts with 2.6, or 2.7. If it is not a usable version ([download Python 2.7](http://www.python.org/download/releases/2.7.3/)). On 32-bit or 64-bit non PPC Mac OS X 10.6 or higher, use the [64-bit/32-bit x86-64/i386 Installer](http://www.python.org/ftp/python/2.7.3/python-2.7.3-macosx10.6.dmg), and on PPC or 32-bit i386 Mac OS X 10.3-10.6, use the [32-bit i386/PPC Installer](http://www.python.org/ftp/python/2.7.3/python-2.7.3-macosx10.3.dmg).
+
+
+### 2. Install git
+
+Install the latest version of [Git for OS X](http://code.google.com/p/git-osx-installer/downloads/list?can=3&q=&sort=-uploaded).
+
+### 3. Download KA Lite
+
+Clone the repository into a directory of your choice. Use `cd` to navigate into the target directory (the files will be put into a subdirectory of your current directory named `ka-lite`), and then run:
+
+`git clone --recursive https://github.com/jamalex/ka-lite.git`
+
+(The `--recursive` is required because it includes [khan-exercises](https://github.com/Khan/khan-exercises) as a git submodule.)
+
+### 4. Run the installation script
+
+Inside the `ka-lite` directory (that you cloned above) you should find a script called `install.sh`. Use `cd ka-lite` to navigate into the directory, and run this script using `./install.sh` to initialize the server database.
+
+### 5. Run the server
+
+(If you're installing the server to test/develop, rather than deploy, follow the [development instructions](docs/DEVELOPMENT.md) instead.)
+
+To start the server, run the `start.sh` script in the `ka-lite` directory.
+
+The local KA Lite website should now be accessible at [http://127.0.0.1:8008/](http://127.0.0.1:8008/) (replace 127.0.0.1 with your computer's external ip address or domain to access it from another connected computer).
+
+
Optional: Install and configure Apache/mod_wsgi
===

0 comments on commit f93d7fe

Please sign in to comment.