diff --git a/docker-swarm-ha/README.md b/docker-swarm-ha/README.md
new file mode 100644
index 0000000..84ad49e
--- /dev/null
+++ b/docker-swarm-ha/README.md
@@ -0,0 +1,17 @@
+# Using Vagrant with OpenStack
+
+These files were created to allow users to use Vagrant ([http://www.vagrantup.com](http://www.vagrantup.com)) to automate the provisioning and de-provisioning of OpenStack instances. This configuration was tested using Vagrant 1.7.4 and version 0.7.0 of [the vagrant-openstack-provider plugin](https://github.com/ggiamarchi/vagrant-openstack-provider).
+
+## Contents
+
+* **README.md**: The file you're currently reading.
+
+* **Vagrantfile**: This file is used by Vagrant to spin up the OpenStack instance. Edit this file to change any of the properties of the OpenStack instance you want created by Vagrant.
+
+## Instructions
+
+Note that you'll need a working OpenStack installation in order to use these files.
+
+1. Edit `Vagrantfile` to ...
+
+Enjoy!