diff --git a/README.md b/README.md
new file mode 100644
index 0000000..74bb99c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# bootstrap k3s cluster
+
+## init repository
+
+local requirements: wireguard-tools, yq, jq, ansible
+
+* adapt inventory.yaml (use external IPs!)
+* run ./generate-keys.sh to generate your wireguard keys
+* do NOT commit your wireguard keys to git, or use ansible-vault
+
+## deploy
+
+`ansible-playbook site.yaml`