diff --git a/README.md b/README.md
index cafcec8..1e7f43c 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,26 @@ Can the app be used by multiple users? **Yes**
 * ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/spip%20%28Community%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/spip/)
 * Jessie x86-64b - [![Build Status](https://ci-stretch.nohost.me/ci/logs/spip%20%28Community%29.svg)](https://ci-stretch.nohost.me/ci/apps/spip/)
 
+## Migrate from SPIP2
+
+**This is not considered as stable yet, please do it with care and only for testing!**
+
+This package handle the migration from SPIP2 to SPIP. For that, your
+SPIP2 application must be **up-to-date** in YunoHost.
+
+You will then have to upgrade your SPIP2 application with this repository.
+This can only be done from the command-line interface - e.g. through SSH. Once you're connected, you simply have to execute the following:
+
+```bash
+sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/spip_ynh spip2 --debug
+```
+
+The `--debug` option will let you see the full output. If you encounter any issue, please paste it.
+
+Note that a cron job will be executed at some time after the end of this
+command. You must wait that before doing any other application operations!
+You should see that SPIP is installed after that.
+
 ## Links
 
  * Report a bug: https://github.com/YunoHost-Apps/spip_ynh/issues
diff --git a/README_fr.md b/README_fr.md
index f2cc20e..7d1ea6c 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -45,6 +45,23 @@ L'application peut-elle être utilisée par plusieurs utilisateurs? **Oui**
 * ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/spip%20%28Community%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/spip/)
 * Jessie x86-64b - [![Build Status](https://ci-stretch.nohost.me/ci/logs/spip%20%28Community%29.svg)](https://ci-stretch.nohost.me/ci/apps/spip/)
 
+## Migration depuis SPIP2
+
+**Ceci n'est pas encore considéré comme stable, veuillez le faire avec soin et uniquement pour test!**
+
+Ce paquet gère la migration de SPIP2 vers SPIP. Pour cela, votre L'application SPIP2 doit être **à jour** dans YunoHost.
+
+Vous devrez ensuite mettre à jour votre application SPIP2 avec ce dépôt.
+Cela ne peut se faire qu'à partir de l'interface en ligne de commande - par exemple via SSH. Une fois connecté, il vous suffit d'exécuter ce qui suit :
+
+```bash
+sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/spip_ynh spip2 --debug
+```
+
+L'option `--debug` vous permettra de voir la sortie complète. Si vous rencontrez un problème, veuillez ouvrir une issue.
+
+Notez qu'une tâche cron sera exécutée après la fin de cette commande. Vous devez attendre cela avant de faire toute autre opération d'application ! Vous devriez voir que SPIP est installé après cela.
+
 ## Links
 
  * Signaler un bug: https://github.com/YunoHost-Apps/spip_ynh/issues