diff --git a/README.md b/README.md
index 8498e56..4902679 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,29 @@
-# CopyMoji
+# Copymoji
+
+Sélecteur d'émojis et de caractères Unicode — clic pour copier.
+Configuration par le fichier `config.js`.
+
+
+## Configuration : `web/config.js`
+
+Editer le fichier de configuration config.js pour personnaliser votre instance.
+- Titre du site
+- Titre de l'onglet
+- Texte sous le titre
+- Logo du site
+- Version de l'app
+- Url de redirection de la version
+- Langue par défaut
+- Thème par défaut
+- Activer l'onglet favoris
+- Personnaliser la liste des favoris
+
+
+## Démarrage
+
+```bash
+cd copymoji
+docker compose up -d --build
+```
+Application accessible sur le port **8080**