diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..026181d
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,35 @@
+# Chasse au trésor en ssh
+Un environnemnet SSH avec des exercices ludiques.
+
+## Licence
+GPLv3
+
+## Installation
+Créer un fichier `config/users.txt` qui contient la liste des utilisateurices (un nom par ligne).  
+ou  
+Créer un fichier `config/passwords.txt` qui contient la liste des couples nom=password (un nom/mot de passe par ligne).  
+
+
+Les comptes seront créés au démarage du conteneur.
+
+## Présentation
+Chaque élève a un dossier perso dans `/home` dans lequel il peut se connecter en SSH à l’aide de son mot de passe dans `config/passwords.txt`.
+
+## Génération des données aléatoires pour les exercices
+ATTENTION ! Cette génération ne doit pas se faire quand les élèves travaillent, leurs exercices seraient alors invalidés !
+```
+TODO
+```
+
+## Re-Génération des exercices
+Pour créer les fichiers et les questions de chaque élèves on utilise la commande suivante.
+Utile si l’élève a sacagé son environnement de travail.
+```
+TODO
+```
+
+## Correction
+Pour suivre la progression des élèves, on utilise le script suivant.
+```
+TODO
+```