The following software packages are required to build and run the khal-remove virtual machine:
- VirtualBox
- Vagrant
- For development, it's also recommended to install the rsync tool (installed by default on most *NIX systems)
The easiest way to install and run KHAL | REMOVE for local development is to build a VM (Virtual Machine) image using Vagrant and VirtualBox:
- In a terminal window, cd to the khal-remove project root and run
vagrant up
. - To have the project files automatically synced with the VM (convenient when developing), run
vagrant rsync-auto
in the project root (preferably from a separate terminal window). - SSH to the VM by running
vagrant ssh
. - In the VM, run
cd /workspace/app
, then./run
to start the web server. - Head to http://192.168.50.42:8000 to use the application.
All software packages dependent on by KHAL | REMOVE are automatically installed during the VM setup (see Prerequsites and vm_setup.sh). More information about individual applications and libraries can be found here:
The Virtual Machine version of KHAL | REMOVE is based on the https://www.debian.org/ GNU/Linux distribution.