From b62a70f32c23d4cf86914db49b2c49d4d19d36c0 Mon Sep 17 00:00:00 2001 From: Daniel Pellarini Date: Fri, 22 Dec 2017 19:46:36 +0100 Subject: [PATCH] Add installation instructions on Vagrant (#711) --- docs/installation/vagrant.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 docs/installation/vagrant.md diff --git a/docs/installation/vagrant.md b/docs/installation/vagrant.md new file mode 100644 index 00000000000..ffc331ff542 --- /dev/null +++ b/docs/installation/vagrant.md @@ -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`