diff --git a/README.md b/README.md
index 6043910..68473dc 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,30 @@
+# Tsunami
+
**Netbox + XO + Terraform + Ansible = The best deployment kit**
-How to run:
-cp passwd.auto.tfvars.example passwd.auto.tfvars
-replace all variable to match your infrastructure
+## Configuration
-edit cloud_network_config.tftpl to replace eth0 (to be changed)
+replace your variables:
+```bash
+# copy password template
+cp passwd.auto.tfvars.example passwd.auto.tfvars
-create a prefix with IP you want to use on netbox
-edit variables.auto.tfvars
+# edit with your infra passwords
+nano passwd.auto.tfvars
+
+# set your template vm network interface
+nano cloud_network_config.tftpl
+
+# create a prefix with IP you want to use on netbox, and set your vm variables
+nano variables.auto.tfvars
+```
You can add your playbook in the folder playbooks/ and use them in variables.auto.tfvars
-then
+## Run
-terraform init
-terraform plan
+```bash
+terraform init
+terraform plan
terraform apply
+```