Install:

• VirtualBox

  • Version 5.0.x

• Vagrant

  • Version 1.8.1
  • If you are behind a proxy, you may need to install and configure the vagrant-proxyconf plugin

• Ansible

  • Version 2.2+
  • For Linux and Mac, install Ansible 2 via pip
  • For Windows (unsupported), go through Ansible Documentation or this blog

Clone the repository to your local machine and enter the cadasta-platform directory. Run the following commands to access the virtual machine.

Provision the VM:

vagrant up --provision

SSH into the VM (automatically activates the Python virtual environment):

vagrant ssh

Enter the cadasta directory and start the server:

cd cadasta
./runserver

To add the Django debug toolbar, use ./runserver --debug.

Open http://localhost:8000/ in your local machine's browser. This will forward you to the web server port on the VM and you should see the front page of the platform site.

See the wiki for details on loading test data.

Within the development VM, from the /vagrant directory run:

py.test cadasta

To get coverage reports run:

py.test cadasta --cov=cadasta  --cov-report=html

This creates a HTML report under htmlcov. See pytest-cov docs for other report formats.

Do this:

vagrant box add dummy https://github.com/mitchellh/vagrant-aws/raw/master/dummy.box
vagrant plugin install vagrant-aws
...

vagrant up --provider=aws ...

Cadasta is grateful for the technical considerations and support provided by:

• BrowserStack
• Opbeat
• Travis CI