diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..a1e9b34a92ab2018475db520d24110ad123aa941
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Create Openstack images for use with Cheaha
+
+# Prerequities
+
+1. [packer](https://www.packer.io/downloads)
+2. python 3.5+
+3. an openstack RC file
+
+# Quickstart
+
+Use your openstack rc file and use the following and you should be able to quickly create an instance:
+
+```bash
+python -mvenv env
+. env/bin/activate
+pip install ansible
+cp openstack.pkrvars.hcl{.example,}
+packer build -var-file=openstack.pkrvars.hcl openstack
+```
+
+# Running
+
+1. Use your openstack rc file
+2. Install ansible (preferably in a virtualenv) and ensure `ansible-playbook` is in `PATH`
+3. Copy `openstack.pkrvars.hcl.example` to `openstack.pkrvars.hcl` and edit in the documented variables
+4. Run `packer build -var-file=openstack.pkrvars.hcl openstack`
diff --git a/openstack/README.md b/openstack/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..d9287a3ae8ba8e4456edcf1ef7607a9366c5f8c7
--- /dev/null
+++ b/openstack/README.md
@@ -0,0 +1 @@
+This contains packer hcl files for creating images. For documentation on packer, see [here](https://www.packer.io/docs); for information about the openstack-specific builder, see [here](https://www.packer.io/plugins/builders/openstack)