diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8050593
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# NixOS-Compose demo compositions
+
+This repository contains a variety of sample [NixOS-Compose](https://nixos-compose.gitlabpages.inria.fr/nixos-compose/) compositions.
+
+They have been developped during a collective project at Polytech Grenoble.
+
+If you want to learn more about the compositions and how to run them, you can [refer to the documentation](https://elegaanz.github.io/nixos-compose-test/).