diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1bc64e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Homelab Nomad
+
+My configuration for creating my home Nomad cluster and deploying services to it.
+
+## Running
+
+    make all
+
+## Design
+
+Both Ansible and Terraform are used as part of this configuration. All hosts must be reachable over SSH prior to running any of this configuration.
+
+To begin, Ansible runs a playbook to setup the cluster. This includes installing Nomad, bootstrapping the cluster and ACLs, setting up NFS shares, creating Nomad Host Volumes, and setting up Wesher as a Wireguard mesh between hosts.
+
+After this is complete, Ansible variables must be set for services to access and configure correctly. This depends on variables to be set based on the sample file.
+
+Finally, the Terraform configuration can be applied setting up all services deployed on the cluster.
+
+## What does it do?
+
+## Step by step
\ No newline at end of file