os-install says rabbitmq is needed, although celery hasn't shown any obvious problems yet

[oweals/karmaworld.git] / README.md

diff --git a/README.md b/README.md
index 23374a02b1362d09049fc86757aa588509f069f6..1c643823fdc57a12e16f4de0e2a3f3f0607087da 100644 (file)
--- a/README.md
+++ b/README.md
@@ -47,7 +47,7 @@ follow:
 
 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`
@@ -60,6 +60,7 @@ follow the steps below.
 1. Ensure the following are installed:
    * `git`
    * `PostgreSQL` (server and client)
+   * `nginx`
    * `Python`
    * `PIP`
    * `virtualenv` and `virtualenvwrapper`
@@ -81,10 +82,13 @@ follow the steps below.
        * Ensure *.py in `secret/` are never added to the git repo. (.gitignore
          should help warn against taking this action)
 
+1. Make sure that /var/www exists, is owned by the www-data group, and that
+   the user is a member of the www-data group.
+
 1. Make sure that you're in the root of the project that you just cloned and
    run
 
-        fab here first_deploy
+        fab -H 127.0.0.1 first_deploy
 
    This will make a virtualenv, install the development dependencies and create
    the database tables.
@@ -97,6 +101,15 @@ follow the steps below.
 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.