Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

70 lines (41 sloc) 2.021 kb


Build Status

The new Mobile Oxford

This repository contains the (server-side) JSON API.


Available at Read the docs

Documentation is also available at /docs in the repo, you need to install required packages (Sphinx) from requirements_dev.txt.

You can generate HTML documentation by running make html inside the docs directory.


  • Solr 4.4
  • Redis
  • libgeos2
  • pip (easy_install pip)

How to run


  • pip install -r requirements.txt

Running the application

  • celery worker --app moxie.worker
  • python

Options available for

  • run with a profiler: python --profiler
  • specify the logging level (INFO by default): python --log-level DEBUG

Periodically, and the first time, you have to run importers to import data into the search index. You can do this via a Python shell:

>>> from moxie.places.tasks import import_all
>>> import_all.delay()

Deploying with Fabric


  • Add your public SSH key to /srv/moxie/.ssh/authorized_keys
  • Execute the fabric script on your local machine, which will then connect to the designated server and run the pre-programmed tasks:

    fab deploy_api:GIT_BRANCH -g USER@GATEWAY -H moxie@PRIVATE_IP

    For example:

    fab deploy_api:master -g -H moxie@

  • Optional: Use an ssh_config file to define the gateway to and provide aliases for machines behind the front-end server, and the user to connect as. Then the -g flag and username become unnecessary and memorable hostnames can be used instead of IP addresses:

    fab deploy_api:master -H

    See puppet/fabric/ubuntu-ssh/ssh_config for examples.

Jump to Line
Something went wrong with that request. Please try again.