diff --git a/README.md b/README.md
new file mode 100644
index 00000000..1d7b7ada
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# malobeo infrastructure
+
+this repository nxios configurations of the digital malobeo infrastructure. it should be used to setup, test, build and deploy different hosts in a reproducible manner.
+
+## creating a new host
+
+currently nixos offers no declarative way of setting up filesystems and partitions. that means this has to be done manually for every new host. [to make it as easy as possible we can use this guide to setup an encrypted zfs filesystem](https://openzfs.github.io/openzfs-docs/Getting%20Started/NixOS/Root%20on%20ZFS.html)
+
+we could create a shell script out of that