From 22f230d19083eddac92e0ed33fffa6f9a0eaf439 Mon Sep 17 00:00:00 2001
From: "ma.azimi@laposte.net" <ma.azimi@laposte.net>
Date: Sat, 20 Jun 2015 13:44:25 +0200
Subject: [PATCH] Add email_migration.md

---
 email_migration.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 email_migration.md

diff --git a/email_migration.md b/email_migration.md
new file mode 100644
index 00000000..0cb935d9
--- /dev/null
+++ b/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.
\ No newline at end of file