diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5b3003f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Hack explo
+
+![acceuil](./accueil.png "Accueil")
+
+Recette vagrant pour déployer une machine virtuel attaquable par les élèves.
+
+Elle s'attaque en explorant d'abord le code HTML et CSS pour trouver un login et mot de passe. Puis en explorant les fichiers pour arriver à se connecter en root.
+
+## Mise en place
+
+Lancement de la VM depuis un serveur ou son ordinateur perso branché sur le réseau.
+
+    vagrant up
+
+La provision de la VM se termine par un `ip addr` pour récupérer l'IP de la machine. Il reste plus qu'à la transmettre aux élèves.
+
+## Intérêts pédagogiques
+
+- Rapide retour sur le HTML et CSS
+- Connections à une machine avec ssh
+- Utilisation des commandes shell pour se déplacer, lister et ouvrir des fichiers
+- Fichiers cachés et droits sur les fichiers
+- Sensibilisation autour des mots de passes
+- Initiation à la sécurité et au pentest
diff --git a/accueil.png b/accueil.png
new file mode 100644
index 0000000..a8e70bf
Binary files /dev/null and b/accueil.png differ