Skip to content
This repository has been archived by the owner on Feb 19, 2019. It is now read-only.

MifosX Vagrant Box Setup

Jump to bottom
Terence Monteiro edited this page Jul 17, 2015 · 4 revisions

You have the option of setting up all MifosX codebase on your local machine, or use a pre-created Vagrant VM Box which has all softwares pre-installed inside it (like npm, bower, java, mysql, etc).

If you want to try the vagrant box, here are the steps:

UPDATE: Currently there is a fresh Vagrant box with instructions at: https://mifosforge.jira.com/wiki/display/MDZ/Quick+Developer+Box+VM+Setup

  1. Install Virtual Box.

  2. Install Vagrant. (might need ruby).

  3. Download MifosX Vagrant Box.

  4. Create a folder called mifos where all the code will reside.

  5. In mifos pull the code by executing the (requires git) commands:

    git clone https://github.com/openMF/community-app.git

    git clone https://github.com/openMF/mifosx.git

  6. In mifos create a folder called mifos-vagrant.

  7. Now you should have 3 folders in Mifos:

    • community-app
    • mifosx
    • mifos-vagrant

  8. Go into mifos-vagrant, and type the command:

    vagrant box add mifosx-centos Mifos_Vagrant_Centos.box

  9. Now, the box should be added, and you should be able to see it with the command:

    vagrant box list

  10. Download the VagrantFile into the mifos-vagrant folder.

  11. Run the command:

vagrant up

  1. This should start your vagrant box. If it prints an error (or does not map shared folder) then try deleting the /etc/udev/rules.d/70-persistent-net.rules file from inside vagrant (by doing a ‘vagrant ssh’ command to go in).

  2. Once vagrant is up, you should be able to vagrant ssh into the box, and go to /Project folder where you will see all your code. You can compile and run the server now from inside the vagrant VM.

  3. Shut down the firewall by executing the command (one time):

    sudo service iptables stop

  4. You can open your Firefox browser on the host machine, and open the file: community-app/app/index.html to browse the app. If it doesn’t work, then go into your vagrant box, and into community-app folder, and run: bower install and npm install and then try again.

  5. To halt your vagrant, run vagrant halt.

  6. If you mess up your vagrant box, you can always fire vagrant destroy and start afresh with vagrant up.

Clone this wiki locally