diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b406ceb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# slurm-lxd
+
+This is a simple repo to hold some configs and scripts to bootstrap a simple
+slurm environment.
+
+As long as the LXD has been initialised and `lxdbr0` is available, this script
+should work as is. 
+
+It will creete a `slurm-master` and 5 x `slurm-comp0X` nodes
+
+Once ths script finishes, you can login to the master using the command beliow
+
+```
+lxc --project hpc exec slurm-master bash
+```
+
+Now you should be able to run any slurm commands
+