diff --git a/README.md b/README.md
index 1fed89c..e9f8eb9 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,15 @@
 # Terraform
+This repository represents the configuration of the `mop` node on a Proxmox server.
+Using Terraform (opentofu), cloud-init and proxmox/bpg provider
+It defines all virtual machines on the node `mop`:
+- `gateway`: Traefik gateway that reloads its configuration automatically when new entry is created in terraform.
+- `bookshelf`: A self developped service that manage a book database.
+- `fefan`: A self developped website for the Event of Girasol association `Le Fefan`
+- `gitea`: A gitea instance where all repository and actions are uploaded.
+- `keycloak`: A keycloak instance for IAM purposes.
+- `wiki`: A wikimedia website for a friend [project](https://benoit.mathieu.wiki)
+- `vaultwarden`: A password manager.
+
 ## Basic Proxmox setup
 Add `TerraformProv` role
 ```sh