--- a
+++ b/Allura/docs/installation.rst
@@ -0,0 +1,29 @@
+Installation
+=================
+
+Easy Setup
+---------------
+
+Our easy setup instructions are in our README.rst file. You can read it online at https://sourceforge.net/p/allura/git/#readme
+
+You should be able to get Allura up and running in well under an hour by following those instructions.
+
+Enabling RabbitMQ
+-----------------
+
+For faster notification of background jobs, you can use RabbitMQ. Assuming a base setup from the README, run these commands
+to install rabbitmq and set it up::
+
+(anvil)~$ sudo aptitude install rabbitmq-server
+(anvil)~$ sudo rabbitmqctl add_user testuser testpw
+(anvil)~$ sudo rabbitmqctl add_vhost testvhost
+(anvil)~$ sudo rabbitmqctl set_permissions -p testvhost testuser "" ".*" ".*"
+(anvil)~$ pip install amqplib==0.6.1 kombu==1.0.4
+
+Then edit Allura/development.ini and change `amqp.enabled = false` to `amqp.enabled = true` and uncomment the other `amqp` settings.
+
+If your `paster taskd` process is still running, restart it::
+
+(anvil)~/src/forge/Allura$ pkill -f taskd
+(anvil)~/src/forge/Allura$ nohup paster taskd development.ini > ~/logs/taskd.log &
+