Vagrant

Vagrant

To aid development (as well as allowing easier evaluation), we use Vagrant. Please note that Vagrant is supposed to be used for development and testing purposes only and must not be used for productive systems.

Quick Vagrant

If you want to get ViMbAdmin with Vagrant up and running quickly, follow these steps:

1. Install Vagrant (see: http://docs.vagrantup.com/v2/installation/index.html)
2. Install VirtualBox (see: https://www.virtualbox.org/)
3. Clone ViMbAdmin to a directory and:

git clone https://github.com/opensolutions/ViMbAdmin.git vimbadmin
cd vimbadmin

4. Spin up a Vagrant virtual machine:

vagrant up

5. Access ViMbAdmin on: http://localhost:8088/

6. Log in with the following username / password:

[email protected] / vagrant

Please see Vagrant’s own documentation for a full description of how to use it fully. To access the virtual machine that the above has spun up, just run the following from the vimbadmin directory:

vagrant ssh

You’ll find the vimbadmin directory mounted under /vagrant, you can sudo su - and you can access MySQL via:

mysql -u root -ppassword vimbadmin

If you prefer to use phpMyAdmin, you’ll find it at http://localhost:8088/phpmyadmin and you can log in with root / password.

Database Details

Spinning up Vagrant in the above manner loads a sample database from vimbadmin/data/vagrant-base.sql. If you have a preferred development database, place a bzip’d copy of it at vimbadmin/vimbadmin-preferred.sql.bz2 before step 5 above.