diff --git a/doc/yunohost.md b/doc/yunohost.md
new file mode 100644
index 0000000..ca0aba7
--- /dev/null
+++ b/doc/yunohost.md
@@ -0,0 +1,16 @@
+# Pleroma and Yunohost
+
+Some information, for all intents and purposes, on the differences between a direct installation of Pleroma (from the _releases_) and installation with the Yunohost application package.
+
+|                             | Official Package           | With Yunohost                           |
+| --------------------------- | -------------------------- | --------------------------------------- |
+| Install directory           | `/opt/pleroma`              | `/var/www/pleroma/live/`                 |
+| Static directory            | `/var/lib/pleroma/static`   | `/etc/pleroma/config.exs`                |
+| Configuration file          | `/etc/pleroma/config.exs`   | `/etc/pleroma/config.exs`                |
+| Command line path           | `/bin/pleroma_ctl`         | `/var/www/pleroma/live/bin/pleroma_ctl`  |
+
+## Things to remember
+
+- The installation of Pleroma with Yunohost is a so-called OTP installation (and not MIX, i.e. from the sources). Have this in mind, as the administration _commands_ are not the same in either case.
+
+- All commands must be run as the `pleroma` user, who is _not_ part of Yunohost `admin` group, it’s not possible to invoque these commands directly with `sudo`.
diff --git a/doc/yunohost_fr.md b/doc/yunohost_fr.md
new file mode 100644
index 0000000..8a99e74
--- /dev/null
+++ b/doc/yunohost_fr.md
@@ -0,0 +1,16 @@
+# Pleroma et Yunohost
+
+Quelques informations, à toutes fins utiles, sur les différences entre une installation directe de Pleroma (depuis les _releases_ du dépôt officiel) et l’installation avec le package d’application de Yunohost.
+
+|                             | Package officiel           | Avec Yunohost                           |
+| --------------------------- | -------------------------- | --------------------------------------- |
+| Répertoire d’installation   | `/opt/pleroma`              | `/var/www/pleroma/live/`                 |
+| Répertoire statique         | `/var/lib/pleroma/static`   | `/etc/pleroma/config.exs`                |
+| Fichier de configuration    | `/etc/pleroma/config.exs`   | `/etc/pleroma/config.exs`                |
+| Ligne de commandes          | `/bin/pleroma_ctl`         | `/var/www/pleroma/live/bin/pleroma_ctl`  |
+
+## A noter
+
+- L’installation de Pleroma avec Yunohost est une installation dite OTP (et non MIX, c’est à dire à partir des sources). Information à mémoriser, dans la mesure où les commandes d’administration ne sont pas les mêmes dans l’un ou l’autre cas.
+
+- Toutes les commandes doivent être exécutées en tant qu’utilisateur `pleroma`, qui n’est _pas_ membre du groupe `admin` de Yunohost, celle-ci ne peuvent donc être invoquées directement avec `sudo`.