diff --git a/readme.md b/readme.md
index f50d95c..219ddc8 100644
--- a/readme.md
+++ b/readme.md
@@ -1,3 +1,24 @@
-#
+# C container implementation
-##
+
+> prerequisite : `make busybox_setup` permit to extract rootfs into [./busybox](./busybox) folder
+
+## build
+
+classique build
+
+`make release`
+
+build with debug
+
+`make debug`
+
+## run
+
+classique run
+
+`./bin/out.ex /bin/ls`
+
+run interactively
+
+`./bin/out.ex -i /bin/sh`