diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2f2fc82e682a3a3f95b2649bb9a422851ab480d8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Spring boot bdd
+
+## Configuration du projet
+
+Le projet utilise les ressources suivantes situées dans le répertoire `src/main/resources` :
+
+- `docker-compose.yml` : Ce fichier permet de lancer deux conteneurs Docker, l'un pour MariaDB et l'autre pour phpMyAdmin.
+- `application.properties` : Ce fichier contient la configuration de Spring Boot .
+- spring.datasource.* => Configuration pour la connexion a la BDD 
+
+## Lancer le projet 
+
+### Exécution de Docker Compose
+
+Exécutez la commande suivante pour démarrer les conteneurs MariaDB et phpMyAdmin :
+
+   ```bash
+   docker-compose up
+   ```
+
+
+### Exécution de spring boot
+
+```bash
+./mvnw spring-boot:run
+```