Updated/Added README.md files

example/README.md

@@ -0,0 +1,45 @@
+# TORch Agent Example
+
+The example creates a Vagrant machine configured with TORch Agent
+
+## Instructions to Run
+
+### Install dependencies
+
+* `docker`
+* `mosquitto_sub`
+    * `apt install mosquitto-clients`
+
+### Run the Broker
+
+Add the following line to your `/etc/hosts` file:
+
+```
+127.0.0.1    mqtt.example.com
+```
+
+Run the broker in a terminal window:
+
+```bash
+cd example
+./run-broker.sh
+```
+
+### Run the Subscriber
+
+In a separate terminal window, run the subscriber:
+
+```bash
+cd example
+./run-subscriber.sh
+```
+
+### Run TORch Agent in Vagrant
+
+Run the Vagrant box in a third terminal window:
+
+```bash
+vagrant up
+```
+
+You should see that the broker received a connection from the Vagrant box at boot up and the subscriber received the onion hostname.  You can use a local `tor` proxy to connect to the vagrant box using SSH and the onion hostname.