development-installation.md

Development Installation

OpenMapKit Server is a NodeJS service, so you'll need NodeJS version 4.x.

Ubuntu & Debian

Install dependencies:

sudo apt-get install default-jre-headless
sudo apt-get install build-essential python-pip git
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install nodejs

Mac

The ODK pyxform component requires python dependencies that are installed via pip. The best way to install pip on a Mac is through Homebrew:

brew install python

Make sure you have installed Java. pyxform has a Java dependency (JavaRosa). Full instructions on Stack Overflow.

brew cask install java

Also make sure you have installed NodeJS and git.

Setup Project

Install project dependencies.

git submodule init
git submodule update
sudo pip install -r requirements.txt
npm install

Turn on server

npm start

If npm start is failing, run npm start --verbose to see detailed log execution. You might encounter Error: Could not locate the bindings file. Run npm install libxmljs to fix this.

NodeJS Version Problems

We are using node version 4.*. If you are having problems with another version, use node version manager.

nvm install
nvm use