Commit 99bdfed5 authored by Hispanico's avatar Hispanico

Created README.md

parent 32f46223
# Ansible Vagrant profile for a OpenWISP2 server
## Background
Vagrant and VirtualBox (or some other VM provider) can be used to quickly build or rebuild virtual servers.
This Vagrant profile installs OpenWISP2 server using the [Ansible](http://www.ansible.com/) provisioner.
## Getting Started
This README file is inside a folder that contains a `Vagrantfile` (hereafter this folder shall be called the [vagrant_root]), which tells Vagrant how to set up your virtual machine in VirtualBox.
To use the vagrant file, you will need to have done the following:
1. Download and Install [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
2. Download and Install [Vagrant](https://www.vagrantup.com/downloads.html)
3. Install [Ansible](http://docs.ansible.com/ansible/latest/intro_installation.html)
4. Open a shell prompt (Terminal app on a Mac) and cd into the folder containing the `Vagrantfile`
5. Run the following command to install the necessary Ansible roles for this profile: `$ ansible-galaxy install -r requirements.yml`
Once all of that is done, you can simply type in `vagrant up`, and Vagrant will create a new VM, install the base box, and configure it.
Once the new VM is up and running (after `vagrant up` is complete and you're back at the command prompt), you can log into it via SSH if you'd like by typing in `vagrant ssh`. Otherwise, the next steps are below.
### Login on OpenWISP2 Server
When the playbook ran successfully, you can log in at:
```
https://192.168.56.2/admin
username: admin
password: admin
```
## License
Licensed under the GPLv3 License. See the LICENSE file for details.
## Author Information
Hispanico
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment