diff --git a/.terraform-docs.yml b/.terraform-docs.yml
new file mode 100644
index 0000000..3fa1265
--- /dev/null
+++ b/.terraform-docs.yml
@@ -0,0 +1,7 @@
+formatter: markdown table
+output:
+  file: README.terraform.md
+  mode: replace
+sort:
+  by: required
+