diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4508966
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# ffmyk-ansible
+sets up ffmyk supernodes
+
+## usage
+- load submodules
+```
+git submodule update --init
+```
+- copy inventory.ini.sample
+```
+cp inventory.ini.sample inventory.ini
+```
+- add hosts to inventory and edit variables in host_vars
+- to install arch on hetzner vms run the bootstrap_arch playbook
+```
+ansible-playbook -i inventory.ini bootstrap_arch.yml
+```
+- to configure the node run
+```
+ansible-playbook -i inventory.ini setup_fastd.yml
+```