Add email_migration.md

email_migration.md

@@ -0,0 +1,37 @@
+# Migrate his emails
+
+*[Documentation linked to YunoHost email](/email_fr)*.
+
+Migration of his emails from a server to an other can be done with two recommended tools: ImapSync or Larch.
+
+This tool must be installed on your desktop computer. The transfer method looks at this schema:
+
+**`Old email server −> desktop computer with ImapSync or Larch −> new email server`**
+
+### ImapSync
+[ImapSync site](http://imapsync.lamiral.info/)
+
+Install ImapSync on your client computer by following this [guide](http://imapsync.lamiral.info/INSTALL):
+```bash
+sudo dnf install imapsync # Under Fedora
+```
+Transfer emails from a server to an other:
+```bash
+imapsync --host1 <domain/IP> --port1 993 --ssl1 --user1 <user> --password1 <password> \
+--host2 <domain/IP> --port2 993 --ssl2 --user2 <user> --password2 <password>
+```
+
+Note that transfer settings `--port 993` and `--ssl` are specific to YunoHost email server.
+
+### Larch
+[Larch site](https://github.com/rgrove/larch/)
+
+After beforehand installed `gem`, install `larch` on your client computer:
+```bash
+sudo gem install larch
+```
+Transfer emails from a server to an other:
+```bash
+larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org
+```
+For other type of tranfer refer you to Larch documentation.