diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f5ac678
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Requirements
+
+- ansible
+- podman >= 4.0 [see CNI network backend issue](https://github.com/containers/podman/issues/8399)
+- netavark >= 1.4
+- aardvark-dns >= 1.4
+
+Variables prefixed by `vault_` are available by unlocking the vault with the master password
+
+# Basic config
+