Skip to content

Commit

Permalink
Add installation instructions on Vagrant (#711)
Browse files Browse the repository at this point in the history
  • Loading branch information
dp87 authored and djaiss committed Dec 22, 2017
1 parent e36de1b commit b62a70f
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions docs/installation/vagrant.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Installing Monica using Vagrant

If you want a quick and easy way to get a Monica development/test environment up and running without having to take care of the installation process yourself, you can create a pre-configured virtual machine using Vagrant.

1. Download and install [Vagrant](https://www.vagrantup.com/) for your operating system
2. Create a folder to put the vagrant configuration files
3. Download the `Vagrantfile` and the `provision.sh` script from [this repository](https://github.com/dp87/vagrantfiles/tree/master/Monica)
4. Put both of these files inside the Vagrant folder you have created in step 2
5. Open a terminal and `cd` to this folder
6. Initialize a virtual machine based on Ubuntu 16.04: `vagrant init ubuntu/xenial64`
7. Launch the virtual machine with `vagrant up`

The virtual machine will be first created and then provisioned using the `provision.sh` script, which will take care of installing Monica for you.

Once the installation process is complete (you will see all of the output in your terminal window), you can either access the virtual machine by typing `vagrant ssh` in your terminal, or access the Monica web interface by opening `http://localhost:8080` in your browser on your host machine.

## Default Monica configuration in the VM

### Database users

* Root database user
* * Username: `root`
* * Password: `changeme`
* Monica database user
* * Username: `monica`
* * Password: `changeme`

### Apache configuration

* The project is installed in `/var/www/html/monica`
* The root folder for the web server is `/var/www/html/monica/public`

0 comments on commit b62a70f

Please sign in to comment.