diff --git a/cluster_setup/README.md b/cluster_setup/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..b2199ffd5b35121375e2f27f60d7969f19aa8635
--- /dev/null
+++ b/cluster_setup/README.md
@@ -0,0 +1,9 @@
+# Intro
+
+This folder contains instructions and files for setting up the example cluster used during the course.  It's included here mostly for my benefit next time I want to redo the setup, but it might be useful to others.
+
+# Cluster infrastructure
+
+The cluster we're using is running on the Heidelberg installation of the de.NBI cloud.  The current design is to create a 4 node cluster (1 controller, 3 compute nodes), with varying hardware specifications for each node so we can demonstrate resource managment.
+
+Job scheduling is doing using [https://slurm.schedmd.com/](SLURM) since it is (a) free and (b) mirrors the infrastructure we're currently using at EMBL.