Please note

This project is no longer supported

We have transitioned over to a containerized setup in order to better keep our production and development work in sync.

Please see the kobo-install installation steps for more details. Linux and OS X are supported. Docker for Windows is not supported at this time; however, you may run kobo-install on Windows using a virtual machine (e.g. VirtualBox).

Vagrant Installation of Kobo Development Box

1. ensure you have virtualbox and vagrant installed

2. In the "dist-kobo-devel" project, run vagrant up

3. Wait (this process will take a long time, 30 mins+ depending on network connection)

4. Open your browser to http://localhost:8000 and log in with the credentials username kobo and password kobo.

5. You can now run these commands from within this directory

• vagrant ssh # ssh into the virtual machine
• vagrant reload --provision # reload the provision script after pulling the latest code

How to load from an existing .box file

• Clone this repository.
• Set an environment variable VM_BOX to equal to the path to the box file, and then run vagrant up.

Linux/OS X example

export VM_BOX="file:///path/to/box.box" && vagrant up

Windows example

set VM_BOX=box.box && vagrant up

Additional commands to know

• vagrant destroy # deletes the vagrant box
• vagrant halt or vagrant suspend # shuts down the machine

In development mode

Clone these projects into a directory "dist-kobo-devel/src":

• koboform (aka dkobo, django kobo) - for creating surveys
• kobocat - for deploying surveys
• kobocat-templates - a project meant to avoid forking the above forked project
• enketo-express - html5 survey previewer / player / editor