# Development Install
If you need to setup the project for development, it is highly recommend that
-you grab an existing development virtual machine for create one yourself, and
-then configure the virtual machine for production with the steps shown in the
-next section. Instructions for creating a virtual machine follow:
+you grab an existing development virtual machine or create one yourself.
+Configure the virtual machine for production with the steps shown in the
+next section (Production Install). Instructions for creating a virtual machine
+follow:
-1. Install (VirtualBox)[http://www.virtualbox.com/]
+1. Install [VirtualBox](http://www.virtualbox.com/)
-1. Install (vagrant)[http://www.vagrantup.com/]
+1. Install [vagrant](http://www.vagrantup.com/) 1.3 or higher
1. Use Vagrant to create the virtual machine.
* While in `cd {project_root}`, type `vagrant up`
If you have installed a virtual machine using `vagrant up`, you can connect
to it by running `vagrant ssh` from `{project_root}`.
+## Connecting to the development website on the VM
+To access the website running on the VM, point your browser at
+http://localhost:6659/ using your host computer.
+
+Port 6659 on your local machine is set to forward to the VM's port 80.
+
+Fun fact: 6659 was chosen because of OM (sanskrit) and KW (KarmaWorld) on a
+phone: 66 59.
+
## Updating the VM code repository
Once connected to the virtual machine by SSH, you will see `karmaworld` in
the home directory. That is the `{project_root}` in the virtual machine.
credentials, etc.
## Other Vagrant commands
-Please see (vagrant documentation)[http://docs.vagrantup.com/v2/cli/index.html]
+Please see [vagrant documentation](http://docs.vagrantup.com/v2/cli/index.html)
for more information on how to use the vagrant CLI to manage your development
VM.