diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e09e842
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# tf-debian-vm
+
+Terraform module to easily create a Debian virtual machine using the libvirt [Terraform provider](https://registry.terraform.io/providers/dmacvicar/libvirt/latest/docs).
+
+Features:
+- SSH host certificate authentication
+- Cloud-init bootstrapped
+- Ability to attach disk for permanent storage
\ No newline at end of file