\r
Repo for installing & running prebuilt distribution of TM351 (production) D2 VM:\r
\r
-* vagrant files etc
\ No newline at end of file
+* vagrant files etc
+
+This is the package intended for distribution to students.
+
+## Usage
+
+Install Virtualbox.
+Install vagrant.
+
+To launch the virtual machine:
+
+`vagrant up`
+
+You should be able to go to:
+
+* `http://127.0.0.1:8888` to see the notebooks
+* `http://127.0.0.1:3334` to see the OpenRefine
+* `http://127.0.0.1:3000` to see an ssh client
+
+If the services don't seem to be running:
+
+`vagrant provision`
+
+To see a full list of vagrant commands:
+
+`vagrant`
\ No newline at end of file