-
-
Notifications
You must be signed in to change notification settings - Fork 2.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add installation instructions on Vagrant (#711)
- Loading branch information
Showing
1 changed file
with
31 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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` |