This commit is contained in:
Nick Bebout 2015-05-28 12:04:57 -05:00
parent 4a536871fe
commit e2bfc931f4
206 changed files with 7348 additions and 7982 deletions

View file

@ -1,15 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" id="TOP">
<head>
<title>Official imapsync migration tool ( release <!--#exec cmd="cat ./VERSION"--> )</title>
<meta name="generator" content="Bluefish 1.0.7"/>
<meta name="author" content="Gilles LAMIRAL"/>
<meta name="date" content="2014-11-14T18:01:28+0100"/>
<meta name="date" content="2015-01-30T17:30:18+0100"/>
<meta name="copyright" content="None"/>
<meta name="keywords" content="imap, transfert, migration"/>
<meta name="keywords" content="imap, transfer, migration"/>
<meta name="description" content="imap migration tool"/>
<meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
<meta http-equiv="content-type" content="application/xhtml+xml; charset=UTF-8"/>
@ -22,14 +22,25 @@
</head>
<body>
<!--
<div id="fb-root"></div>
<script type="text/javascript" src="W/fb-root.js"></script>
-->
<ul class="none">
<li>Are your <a href="#imap_server_success">imap servers <b>supported</b></a> by imapsync?</li>
<li>Buy <a href="#buy_all"><b>imapsync</b></a> ( imapsync.exe + source code for any OS )</li>
<li><a href="#WHATIS">What is imapsync?</a></li>
<li><a href="#AUTHOR">Contact the author, Gilles LAMIRAL</a></li>
<li><a href="#buy_all">Buy <b>imapsync</b></a> ( imapsync.exe + source code for any OS )</li>
<li><a href="#NUMBERS">Facts and figures</a></li>
<li><a href="#DOC_BASIC">How to transfer a single mailbox on Windows</a></li>
<li><a href="#DOC_BASIC_UNIX">How to transfer a single mailbox on Unix</a></li>
<li><a href="#DOC_MASS">How to transfer many mailboxes</a></li>
<li><a href="#MAILING-LIST">Discuss or search on the mailing-list</a></li>
<li><a href="#doc">Documentation</a></li>
<li><a href="S/news.shtml">News about imapsync <!--#exec cmd="cat ./VERSION" --> and previous releases</a></li>
<li><a href="S/imapservers.shtml">List of the 62 imap server softwares <b>supported</b></a> by imapsync</li>
<li><a href="S/external.shtml">Similar softwares and external services</a></li>
</ul>
@ -38,26 +49,31 @@
</script>
</div>
<div id="centered-logo" class="center">
<a href="http://imapsync.lamiral.info/">
<img src="W/images/logo_imapsync.png" width="486" height="309" alt="imapsync logo"/>
</a>
<h1>Welcome to the imapsync web site!</h1>
<!-- I use ssi here only to pass a strict xhtml validation that facebook can't pass -->
<!--#include file="W/tw-hash.html" -->
<!-- include file="W/tw-hash.html" -->
<!-- include file="W/fb-like.html" -->
<h2>Copy all your emails elsewhere!</h2>
</div>
<h2>What is imapsync?</h2>
<h2>What is imapsync? <a id="WHATIS" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>
The purpose of imapsync is to <b>migrate</b> IMAP accounts or to <b>backup</b> IMAP accounts.
IMAP is one of the three current standard protocols to access mailboxes,
the two other are POP3 and HTTP with webmails, webmail are often tied to an IMAP server.
the two other are POP3 and HTTP with webmails,
webmails are often tied to an IMAP server.
</p>
<p><b>imapsync</b> software is a command line tool that allows incremental and
@ -89,11 +105,11 @@ or <a href="http://isync.sourceforge.net/"><b>mbsync</b></a> (written by Michael
for <b>bidirectionnal (2 ways) synchronizations</b>.
</p>
<p>Alternatives to imapsync are listed in the <a href="#similar"><b>Similar softwares</b></a> section.
<p>Alternatives to imapsync are listed in the <a href="S/external.shtml"><b>Similar softwares</b></a> section.
</p>
<!--
<p>Imapsync used to be free, open and gratis, that was before november 2010.
<p>Imapsync used to be free, open and gratis, that was before November 2010.
Now imapsync is free, open and not gratis from the homepage.
Imapsync is still under the <a href="./NOLIMIT">NOLIMIT</a> license,
claiming no limit to do anything with this work and this license,
@ -108,292 +124,18 @@ See detailed explanation and motivation here when
</p>
-->
<h2><a id="NUMBERS"></a>Facts and figures for 2011-2014</h2>
<ul>
<li><b>4000 to 5000 </b>users per month (48000 users a year).</li>
<li>6 to 39 millions mailboxes transfers per month.</li>
<li><b>158 millions</b> transfers for 2013, that is five whole mailboxes synced per second.
2014 should reach more than 220 millions transfers.</li>
<div id="right-tronche">
<img
alt="Gilles LAMIRAL"
src="W/images/gilles_lamiral_400x400.jpeg"
width="200" height="200"
/>
</div>
<li><b>Operating systems</b> run by imapsync users (in 2013):
<ul>
<li><b>Linux: 70%</b></li>
<li><b>Win32: 14%</b></li>
<li><b>Darwin: 6%</b></li>
<li>FreeBSD: 10%</li>
<li>Solaris: 0.15%</li>
<li>OpenBSD: 0.02%</li>
<li>Other: 0.46%</li>
</ul>
</li>
<li><b>Highest use rate</b>: about <b>56 millions</b> of IMAP mailbox transfers by just one user</li>
</ul>
<p>
Where all those numbers come from?
To know wether a newer imapsync exists or not, imapsync does a http GET to the file
<a href="http://imapsync.lamiral.info/VERSION">VERSION</a>.
Via the <b>User-agent</b> parameter it also sends:</p>
<ul>
<li>imapsync release</li>
<li>Perl version</li>
<li>Mail::IMAPClient version</li>
<li>Operating System</li>
</ul>
<p>You can <b>remove this behavior</b> by adding option <b>--noreleasecheck</b> on the command line
(or by setting $releasecheck = 0 in the source code).
Check <a href="http://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2013-4279">CVE-2013-4279</a>.
</p>
<h2><a id="latest"></a>Latest release is imapsync
<!--#exec cmd="cat ./VERSION" -->
<h2>Contact the author, Gilles LAMIRAL <a id="AUTHOR" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>imapsync <!--#exec cmd="cat ./VERSION" --> was written on <!--#flastmod file="./VERSION" --></p>
<div id="osw_imapsync"></div>
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.3/jquery.min.js" type="text/javascript"></script>
<script src="http://static.oswatershed.org/js/package_badge.js" type="text/javascript"></script>
<script type="text/javascript">$(document).ready(function(){ package_badge("imapsync", "#osw_imapsync"); });</script>
<p>See <b><a href="ChangeLog">ChangeLog</a></b> to know what's new in details since 2001.</p>
<p>New features or bugfixes since previous releases:</p>
<!--
<ul>
<li><b>1.604</b></li>
<li><b>Enhancement</b>: </li>
<li><b>Enhancement</b>: </li>
<li><b>Enhancement</b>: </li>
<li><b>Enhancement</b>: </li>
<li><b>Usability</b>: </li>
<li><b>Usability</b>: </li>
<li><b>Usability</b>: </li>
<li><b>Usability</b>: </li>
<li><b>Bug fix</b>: </li>
<li><b>Bug fix</b>: </li>
<li><b>Bug fix</b>: </li>
<li><b>Bug fix</b>: </li>
<li><b>Refactoring</b>: </li>
<li><b>Refactoring</b>: </li>
<li><b>Refactoring</b>: </li>
<li><b>Refactoring</b>: </li>
</ul>
-->
<ul>
<li><b>1.607</b> Folders showed also in utf8.</li>
<li><b>Caveat to upgrade on Unix!</b>: New <b>Unicode::String</b> Perl module dependency, for utf8 output. See the <a href="INSTALL">INSTALL</a> file.</li>
<li><b>Enhancement</b>: Added --skipemptyfolders to skip empty host1 folders. They are not created on host2.</li>
<li><b>Enhancement</b>: Windows exe now uses IO::SSL 2.002 instead of 1.98 (is it an really an enhancement?).</li>
<li><b>Usability</b>: Remove /x from regexes applied with --include and --exclude. Blanks no longer have to be explicit with \ or [ ].</li>
<li><b>Usability</b>: Added utf8 output for folder names, utf7imap special characters are not user friendly readable</li>
<li><b>Usability</b>: Moved foldersizes output after folders lists output.</li>
<li><b>Usability</b>: Added total size transferred after each message copied.</li>
<li><b>Usability</b>: After ETA added number of total to be synced, as a denominator dddd after each message copied, nnn/dddd,
where nnn is the number of messages copied. Before there was only nnn without /dddd.</li>
<li><b>Bug fix</b>: Cache fix on Windows. File paths with brackets [] are special, they have to be escaped with glob.
For example, [Gmail] must be written [[]Gmail[]].</li>
<li><b>Bug fix</b>: Added several checks if IsUnconnected. Goal avoid imap commands while disconnected.
Reconnexion would be better anyway.</li>
</ul>
<ul>
<li><b>1.597</b> Small things</li>
<li><b>Enhancement</b>: Added --nomixfolders to avoid merging folders that are considered different on host1 but the same on destination host2
because of case sensitivities and insensitivities.</li>
<li><b>Bug fix</b>: Fixed "imapsync doesn't see created folders in the listing of folder sizes at the end". (second time this bug shows up)</li>
</ul>
<ul>
<li><b>1.592</b> Logging by default! (an internal feature now)</li>
<li><b>Caveat to upgrade</b>: New <b>IO::Tee</b> Perl module dependency, for logging. See the <a href="INSTALL">INSTALL</a> file.</li>
<li><b>Windows upgrade</b>: Win32 binary is now distributed in a zip file with two batches scripts ready to use it.</li>
<li><b>Enhancement</b>: Added logging by default in subdirectory <b>./LOG_imapsync/</b></li>
<li><b>Enhancement</b>: <b>Added option --log turned on by default</b>. Use --nolog to disable logging.</li>
<li><b>Enhancement</b>: Added option --logfile. Default is like ./LOG_imapsync/YYYY_MM_DD_HH_MM_SS_user2.txt
where YYYY_MM_DD_HH_MM_SS is the launching date and time like 2014_05_20_23_45_10</li>
<li><b>Enhancement</b>: Added option <b>--disarmreadreceipts</b> to fix resending read receipts on host2. A must with Exchange as host2.</li>
<li><b>Enhancement</b>: Added FTGate support (no EXAMINE imap command used anymore).</li>
<li><b>Usability</b>: Updated the code to easily switch on --noreleasecheck by default but allowing --releasecheck (some users want this feature).</li>
<li><b>Usability</b>: Warn syncing messges will not be simulated when --dry mode is on and folder on host2 does not exist yet.</li>
<li><b>Bug fix</b>: Make TLS works with last IO::Socket::SSL default value (Added SSL_verify_mode => 'SSL_VERIFY_NONE') in --tls mode.</li>
<li><b>Bug fix</b>: Fixed bug when creating folders on host2 with --sep2=\\ (Lotus Notes).</li>
<li><b>Bug fix</b>: Try to get folder size when a folder on host2 has the same name but with a different case
like OLD_MAIL -> old_mail. This avoids "does not exist" output.</li>
</ul>
<ul>
<li><b>1.584</b></li>
<li><b>Enhancement</b>: Added --minmaxlinelength to select messages with long lines only.
It helps to diagnostic Echange error on messages with lines longer than 9000 characters</li>
<li><b>Enhancement</b>: Added --debugmaxlinelength</li>
<li><b>Bug fix</b>: --ssl1 --tls2 was buggy because of default SSL_VERIFY_PEER.
"Can not go to tls encryption on [localhost]:Unable to start TLS: Cannot determine peer hostname for verification..."</li>
<li><b>Bug fix</b>: Check if going to tls is ok, exit otherwise with explicit error message.
Thanks to Dennis Schridde for reporting this ugly bug that deserves this <a href="http://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2014-2014">CVE-2014-2014</a>.</li>
<li><b>Debug</b>: Print separator given by NAMESPACE even when --sep1 oe --sep2 is used.</li>
<li><b>Debug</b>: Prints prefix given by NAMESPACE even when --prefix1 or --prefix2 is used.
It is a preparation for advising not to use --prefix unless suggested.</li>
</ul>
<p><b>Good changes</b> made before, listed because <b>they can help</b>:
</p>
<ul>
<li><b>Enhancement</b>: Added <b>--skipcrossduplicates</b> to avoid copying messages that are already copied in another folder, good <b>from Gmail to X</b>.</li>
<li><b>Enhancement</b>: Added --debugcrossduplicates to print which messages (UIDs) are skipped with --skipcrossduplicates (and in what other folders they are).</li>
<li><b>Enhancement</b>: Added --folderfirst string: sync this folder first. --folderfirst "Work" --folderfirst "Friends"</li>
<li><b>Enhancement</b>: Added --folderlast string: sync this folder last. --folderlast "[Gmail]/All Mail" etc.</li>
<li><b>Enhancement</b>: Added <b>--maxmessagespersecond</b> to limit messages tranfer rate and fix <b>Office365 throttle limitation</b> (use --maxmessagespersecond 4).</li>
<li><b>Enhancement</b>: Added --maxbytespersecond to limit byte transfer rate.</li>
<li><b>Enhancement</b>: Added --debugmemory option that prints memory consumption after each message is copied.</li>
<li><b>Enhancement</b>: Added --authmech EXTERNAL.</li>
<li><b>Enhancement</b>: Adapted behavior for allowing --maxdate --mindate with --noabletosearch.
Use internat date instead of Date: header.</li>
<li><b>Enhancement</b>: QQMail IMAP4Server success (with --noabletosearch option) </li>
<li><b>Usability</b>: Apply same treatment to --delete2duplicates as --delete2.
If --uidexpunge2 can be done, do it, else do --expunge2 (unless --nouidexpunge2 or --noexpunge2).</li>
<li><b>Usability</b>: Added --timeout in the --help output. Default timeout is 120 seconds now
(was nothing by imapsync, 600 with underlying modules).</li>
<li><b>Enhancement/Bug fix</b>: Added --ssl1_SSL_version and --ssl2_SSL_version to force the SSL_version
in case the default auto-negociation does not work. Example: <b>--ssl1 --ssl1_SSL_version SSLv3</b></li>
<li><b>Enhancement</b>: Added option --messageidnodomain to fix Mailenable bug changing the domain part of Message-Id header, and avoid duplicates</li>
<li><b>Enhancement</b>: Added option --syncflagsaftercopy to fix Mailenable bug not getting the flags with the APPEND</li>
<li><b>Enhancement</b>: Added option <b>--maxlinelength</b> to skip messages whose max line length is over a number of bytes.
Exchange 2013 and Office365 need <b>--maxlinelength 1000</b> (which is a RFC2822 must) to avoid disconnections.</li>
<li><b>Usability</b>: Added --fixInboxINBOX, turned on by default, to map automatically Inbox INBOX folder names.</li>
<li><b>Usability</b>: IMAP server removing consecutive spaces on the header part doesn't generate duplicates (MailEnable does that)</li>
<li><b>Usability</b>: SSL_verify_mode 0 to avoid warning about Man-In-The-Middle.</li>
<li><b>Enhancement</b>: Added XOAUTH authentication. Thanks to Eduardo Bortoluzzi Junior.</li>
<li><b>Enhancement</b>: Added <b>--search1</b> and <b>--search2</b> to allow different searches on each host.</li>
<li><b>Usability</b>: Added --delete1 as an alias for --delete</li>
<li><b>Speed</b>: Option <b>--nocheckmessageexists is activated by default</b> since --checkmessageexists often slow down transfers too much.</li>
<li><b>Usability</b>: Option --foldersizesatend is on if --foldersizes is on. Off if --nofoldersizesatend</li>
<li><b>Usability</b>: Added <b>host2 minus host1 statistic</b>: number of messages and bytes.
One difference at the start and one at the end.
Useful to <b>detect quickly a difference between host2 and host1</b>.
Need both --foldersizes and --foldersizesatend options (which are on by default).</li>
<li><b>Usability</b>: Added <b>--foldersizesatend</b>.
It gets the folders sizes at the end of the whole transfer.
Turned on by default (use --nofoldersizesatend to turn it off).</li>
<li><b>Enhancement</b>: Added option <b>--delete2duplicates</b>;
it deletes messages in host2 that are duplicates.
--delete2duplicates is on when --delete2 is set unless --nodelete2duplicates is set too.
</li>
<li><b>Enhancement</b>: Added option <b>--pidfilelocking</b>;
it aborts imapsync, when just launched,
in case another imapsync may be running.
Turned off by default</li>
<li><b>Usability</b>: Added option <b>--showpasswords</b>.
it shows passwords on output instead of "MASKED".
Turned off by default.
Useful to restart a run by reading the log
or to see what happen with special characters.
</li>
<li><b>Bug fix</b>: Added option <b>--fixslash2</b>
to avoid the '<b>Invalid mailbox name</b>' error.
It acts when --sep1 is character / and --sep2 is not character /
and host1 folder name contains --sep2 characters.
Turned on by default (--nofixslash2 to unable it).</li>
<li><b>Enhancement</b>: Added option <b>--noabletosearch</b>
to allow the listing of messages without the imap "SEARCH ALL" command.
It's useful for playing with poor imap servers like <b>Softalk 7.6.4</b>
(8.6 is fine with SEARCH ALL).</li>
<li><b>Enhancement</b>: Added <b>--noexpungeaftereach</b>
to speedup --delete --expunge from Gmail.</li>
<li><b>Enhancement</b>: Added option <b>--nocheckmessageexists</b> to <b>speed up</b> with <b>Tobit imap server</b> as host1.</li>
<li><b>Enhancement</b>: Added option --exitwhenover option <b>to avoid locking</b>
when transfers exceed maximum limit.
See for example <a href="http://support.google.com/a/bin/answer.py?hl=en&amp;answer=1071518">this Gmail constraint</a>
<ul>
<li>imapsync ... --exitwhenover 2500000000 # 2.5GB if <b>host1 is Gmail</b></li>
<li>imapsync ... --exitwhenover 500000000 # 500MB if <b>host2 is Gmail</b></li>
</ul>
</li>
<li><b>Usability</b>: Default headers used to identify a message are now "Message-Id" and "Received"
(<b>Exchange compatibility</b> bu default).</li>
<li><b>Enhancement</b>: Added option --addheader to fix the issue
"ignored (no header so we ignore this message)" (on <b>Sent</b> folder usually).
Thanks to Ameir Abdeldayem</li>
<li><b>Enhancement</b>: Added --nofilterflags to check any STORE flags
by ignoring PERMANENTFLAGS (Exchange tests)</li>
</ul>
<h2><a id="DOC_BASIC"></a>Simple transfer on Windows</h2>
<p>
Batch file example <b><a href="./examples/imapsync_example.bat">imapsync_example.bat</a></b>
that you can easily adapt with your parameters.
</p>
<h2><a id="DOC_BASIC_UNIX"></a>Simple transfer on Linux</h2>
<p>
Bourne shell script example <b><a href="./examples/imapsync_example.sh">imapsync_example.sh</a></b>
that you can easily adapt with your parameters.
</p>
<h2><a id="DOC_MASS"></a>Massive transfers (many mailboxes)</h2>
<p>
In order to migrate many mailboxes, you should use a loop over a csv
file containing only the data credentials.
An example of this file is <b><a href="./examples/file.txt">file.txt</a></b>,
it can be used with the two following command scripts.<br/>
On Windows, see <b><a href="./examples/sync_loop_windows.bat">sync_loop_windows.bat</a></b>
batch example.<br/>
On Unix, see <b><a href="./examples/sync_loop_unix.sh">sync_loop_unix.sh</a></b>
example.
</p>
<h2><a id="AUTHOR"></a>Who is the author?</h2>
<p>
<a href="http://fr.linkedin.com/in/gilleslamiral">
@ -407,14 +149,9 @@ example.
<p>Good feedback is always welcome, bad feedback is often welcome.</p>
<h2><a id="WHERE_TALK"></a>Where to talk about imapsync?</h2>
<p>A nice place to talk about imapsync is the public
imapsync mailing-list (see below section <a href="#MAILING-LIST">Mailing-List</a>).
</p>
<h2><a id="buy_all"></a>Buy imapsync</h2>
<h2>Buy imapsync <a id="buy_all" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>Buy complete and <b>latest imapsync</b> for <b>50 EUR</b>.
There is no trial version but I offer 30-day money back guarantee.
@ -440,7 +177,6 @@ been supporting imap migrations since 2001.
</p>
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<p>
<input type="hidden" name="cmd" value="_s-xclick"/>
@ -451,13 +187,12 @@ been supporting imap migrations since 2001.
<option value="Software only. For individual use.">Software only. For individual use. &euro;50,00 EUR</option>
<option class="bold" value="Software + Support. For professional use.">Software + Support. For professional use. &euro;100,00 EUR</option>
<option value="Support only. For professional use.">Support only. For professional use. &euro;100,00 EUR</option>
</select>
</select> Professionals buyers outside France are <b>VAT exempted</b>. Individuals or French buyers are <b>VAT taxed</b>.
<br/>
<input type="hidden" name="on1" value="VAT if professional in Europe"/>
Enter your <b>VAT</b>
<input type="text" name="os1" size="17" maxlength="17" />
<b> if you're a European professional</b> (for accounting).
It's 2 letters followed by 11 digits, for example mine is FR74429303332.
In case <b>you're a European professional</b>, please enter your <b>VAT number</b>
<input type="text" name="os1" size="17" maxlength="17" /> it's for accounting and customs declaration.
VAT is often 2 letters followed by 11 digits, for example mine is FR74429303332.
<br/>
<input type="hidden" name="currency_code" value="EUR"/>
@ -468,7 +203,7 @@ name="submit" alt="PayPal - The safer, easier way to pay online!"/>
</form>
<p>
You will be redirected to a <b>download link just after</b> the payment.<br/>
At the end of the payment Paypal will proposed you to go back to the site, this link brings you to <b>imapsync download</b>.<br/>
You will also receive an email from <b>gilles.lamiral@laposte.net</b> a few minutes later
(can fall in Spam folder sometimes).<br/>
In order to get an accurate invoice, please make sure the delivery postal address you enter in Paypal
@ -476,8 +211,11 @@ suits your accounting department's, since revised editing is not easy and prohib
The gpg signed <b>invoice</b> will be sent within <b>a few days by email</b>.
</p>
<p>If you can not pay with a credit card via Paypal then
you can use a bank transfer on this bank account:<br/>
<p>If you can't pay with a credit card via Paypal then it is possible to pay via a bank transfer.
It will surely add extra work editing the invoice, back and forth getting good coordinates,
so I will mandatory charge both software+support for payment via bank transfer, that is 100 EUR.
Drop me an email to test imapsync and to be sure it will do what you need it to do, before any payment.<br/>
The bank account references are:<br/>
NAME: <b>MR LAMIRAL GILLES</b> <br/>
IBAN: <b>FR76 1360 6000 9900 0332 2748 564</b> <br/>
Code BIC/Swift: <b>AGRIFRPP836</b>
@ -495,7 +233,7 @@ Code BIC/Swift: <b>AGRIFRPP836</b>
<li>Facebook: <a href="https://www.facebook.com/imapsync">https://www.facebook.com/imapsync</a></li>
</ul>
<p>The support is done in English, <b>mostly by email</b> or eventually phone/skype/google+/jabber.
<p>The support is done in English, <b>mostly by email</b> or possibly phone/skype/google+/jabber.
Office hours start at 10:00, end at 16:00 UTC, extra time is possible in case of emergency.
The <b>support aims at helping you to get your imap migration job done</b>, quickly if possible.
Support includes things like <b>no time to read the documentation</b>,
@ -507,9 +245,100 @@ running in parallel, etc.
</p>
<h2><a id="doc"></a>Documentation</h2>
<p>Read the <a href="INSTALL">INSTALL</a> file
<h2>Facts and figures <a id="NUMBERS" href="#TOP"><small>(back to menu)</small></a>
</h2>
<ul>
<li><b>4000 to 7000 </b>users per month (44000 users a year).</li>
<li>6 to 40 millions mailboxes transfers per month.</li>
<li><b>215 millions</b> transfers for 2014,
that is seven whole mailboxes synced per second in average.
</li>
<li><b>Operating systems</b> run by imapsync users (in 2014):
<ul>
<li><b>Linux: 65%</b></li>
<li><b>Win32: 16%</b></li>
<li><b>FreeBSD: 12%</b></li>
<li><b>Darwin: 6%</b></li>
<li>Solaris: 0.15%</li>
<li>OpenBSD: 0.01%</li>
<li>Other: 0.52%</li>
</ul>
</li>
<li><b>Highest use rate</b>: about <b>56 millions</b> of IMAP mailbox transfers by just one host</li>
</ul>
<p>
Where all those numbers come from?
To know whether a newer imapsync exists or not, imapsync does a http GET to the file
<a href="http://imapsync.lamiral.info/VERSION">VERSION</a>.
Via the <b>User-agent</b> parameter it also sends:</p>
<ul>
<li>imapsync release</li>
<li>Perl version</li>
<li>Mail::IMAPClient version</li>
<li>Operating System</li>
</ul>
<p>You can <b>remove this behavior</b> by adding option <b>--noreleasecheck</b> on the command line
(or by setting $releasecheck = 0 in the source code).
Check <a href="http://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2013-4279">CVE-2013-4279</a>.
</p>
<h2>How to transfer a single mailbox on Windows <a id="DOC_BASIC" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>
A basic (and really working) example in a DOS window is the following: </p><pre>
.\imapsync.exe --host1 test1.lamiral.info --user1 test1 --password1 "secret1" ^
--host2 test2.lamiral.info --user2 test2 --password2 "secret2"
</pre>
<p>But it's better to edit a batch file and run it by a double-click.
Take this batch file example <b><a href="./examples/imapsync_example.bat">imapsync_example.bat</a></b>
and adapt with your own parameters.
</p>
<h2>How to transfer a single mailbox on Linux/Unix <a id="DOC_BASIC_UNIX" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>
A basic (and really working) example in a shell terminal is the following: </p><pre>
imapsync --host1 test1.lamiral.info --user1 test1 --password1 "secret1" \
--host2 test2.lamiral.info --user2 test2 --password2 "secret2"
</pre>
<p>
But it's better to edit a shell script and run it in a terminal.
Take this Bourne shell script example <b><a href="./examples/imapsync_example.sh">imapsync_example.sh</a></b>
and adapt with your own parameters.
</p>
<h2>How to transfer many mailboxes <a id="DOC_MASS" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>
In order to migrate many mailboxes, you should use a loop over a csv
file containing only the data credentials.
An example of this file is <b><a href="./examples/file.txt">file.txt</a></b>,
it can be used with the two following command scripts.<br/>
On Windows, see <b><a href="./examples/sync_loop_windows.bat">sync_loop_windows.bat</a></b>
batch example.<br/>
On Unix, see <b><a href="./examples/sync_loop_unix.sh">sync_loop_unix.sh</a></b>
example.
</p>
<h2>Documentation <a id="doc" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>Read the <a href="INSTALL">INSTALL</a> file and look at the <a href="INSTALL.d/">INSTALL.d/*</a> directory
to know how to install imapsync on your system.<br/>
Windows users should read directly <a href="README_Windows.txt">README_Windows.txt</a>.
</p>
@ -518,8 +347,13 @@ Windows users should read directly <a href="README_Windows.txt">README_Windows.t
to understand imapsync and succeed in your migration or backup.
</p>
<p>The <a href="FAQ">FAQ</a> file presents Frequently Asked Questions
(and not so frequently asked ones).
<p>The <a href="OPTIONS">OPTIONS</a> file lists main options
to change default imapsync behavior and adapt it to your context.
</p>
<p>The <a href="FAQ">FAQ</a> and <a href="FAQ.d/">FAQ.d/*</a> files present Frequently Asked Questions
(and not so frequently asked ones) and their answers.
</p>
<p>The <a href="ChangeLog">ChangeLog</a>
@ -536,16 +370,17 @@ lists what may be coded or done in the future.
<p>What you're allowed to do with imapsync is listed in the <a href="LICENSE">LICENSE</a> file (well worth it).
</p>
<h2><a id="MAILING-LIST"></a>The imapsync mailing list</h2>
<h2>Discuss or search on the English imapsync mailing-list <a id="MAILING-LIST" href="#TOP"><small>(back to menu)</small></a>
</h2>
<p>
The public mailing-list may be the best way to get free and gratis support (not as quick as the professional support).<br/>
The English public mailing-list may be the best way to get free and gratis support (not as quick as the professional support).<br/>
You can write to the mailing-list even if you're not subscribed to it.<br/>
In that case you will receive a confirmation message each time you post (to avoid spam).
</p>
<p>
To <b>write</b> on the mailing-list, the address is:
<b>imapsync@linux-france.org</b><br/>
<b>imapsync@linux-france.org</b> (English language list, hosted in France)<br/>
</p>
<p>
@ -581,178 +416,11 @@ lists what may be coded or done in the future.
</form>
<p>
<b>Thank you for your participation to the imapsync mailing-list!</b>
<b>Thank you for your participation to the English imapsync mailing-list!</b>
</p>
<h2><a id="imap_server_success"></a>Lists of imap server software failures and success stories</h2>
<p>Let's start with reported <b>failure stories</b> over the past.<br/>
Maybe <b>new imapsync releases can run successfully with them</b>.<br/>
Don't hesitate to have a try, It's been a long time since last failure occured,
I will help you and make efforts to switch them to the success list,
that's my job.
</p>
<ul>
<li>DBMail 0.9, 2.0.7 (GPL). But most other DBMail releases are supported (see below).</li>
<li><b>Hotmail</b> since hotmail.com does not provide IMAP access.</li>
<li>Imail 7.04 (maybe).</li>
<li>MailEnable 1.54 (Proprietary) but MailEnable 4.23 is supported. </li>
<li>(2011) <b>MDaemon 12.0.3</b> as <b>host2</b>
but MDaemon is <b>supported as host1</b>.
MDaemon is simply buggy with the APPEND IMAP command with any IMAP email client.
</li>
</ul>
<p>Now the long reported <b>success stories</b> list: <b>
62 different imap server softwares supported!</b><br/>
[host1] means "source server" and [host2] means "destination server":
</p>
<!--
(<a href=""></a>)
-->
<ul>
<li>1und1 H mimap1 84498 [host1], H mibap4 95231 [host1](<a href="http://www.1und1.de/">http://www.1und1.de/</a>)</li>
<li>a1.net imap.a1.net IMAP4 Ready [host1] </li>
<li><b>Apple Server</b> 10.6 Snow Leopard [host1] </li>
<li>Archiveopteryx 2.03, 2.04, 2.09, 2.10 [host2], 3.0.0 [host2]
(OSL 3.0) (<a href="http://www.archiveopteryx.org/">http://www.archiveopteryx.org/</a>)</li>
<li>Atmail 6.x [host1] <a href="http://atmail.com/">http://atmail.com/</a></li>
<li>Axigen Mail Server Version 8.0.0 (<a href="http://www.axigen.com/">http://www.axigen.com/</a>)</li>
<li>BincImap 1.2.3 (GPL) (<a href="http://www.bincimap.org/">http://www.bincimap.org/</a>)</li>
<li>CommuniGatePro server (Redhat 8.0) (Solaris), CommuniGate Pro 5.2.17[host2] (CentOS 5.4)
(<a href="http://www.communigate.com/">http://www.communigate.com/</a>) </li>
<li>Courier IMAP 1.5.1, 2.2.0, 2.1.1, 2.2.1, 3.0.8, 3.0.3, 4.1.1 (GPL)
(<a href="http://www.courier-mta.org/imap/">http://www.courier-mta.org/imap/</a>) </li>
<li>Critical Path (7.0.020) </li>
<li>Cyrus IMAP 1.5, 1.6,
2.1, 2.1.15, 2.1.16, 2.1.18
2.2.1, 2.2.2-BETA, 2.2.3, 2.2.6, 2.2.10, 2.2.12, 2.2.13,
2.3-alpha (OSI Approved), 2.3.1, 2.3.7, 2.3.16
(<a href="http://cyrusimap.web.cmu.edu/">http://cyrusimap.web.cmu.edu/</a>)
</li>
<li>David Tobit V8. (<a href="http://www.tobit.com/">http://www.tobit.com/</a>) </li>
<li>DBMail 1.2.1, 2.0.4, 2.0.9, 2.2rc1 (GPL).
2.0.7 seems buggy. (<a href="http://www.dbmail.org/">http://www.dbmail.org/</a>) </li>
<li>DBOX 2.41 System [host1] (<a href="http://www.dbox.handshake.de/">http://www.dbox.handshake.de/</a>).</li>
<li>Deerfield VisNetic MailServer 5.8.6 [host1]
(<a href="http://www.deerfield.net/products/visnetic-mailserver/">http://www.deerfield.net/products/visnetic-mailserver/</a>) </li>
<li>dkimap4 [host1] </li>
<li>Domino (Notes) 4.61[host1], 6.5, 5.0.6, 5.0.7, 7.0.2, 6.0.2CF1, 7.0.1[host1], 8.0.1[host1]
(<a href="http://www-01.ibm.com/software/lotus/products/notes/">http://www-01.ibm.com/software/lotus/products/notes/</a>) </li>
<li><b>Dovecot</b> 0.99.10.4, 0.99.14, 0.99.14-8.fc4, 1.0-0.beta2.7,
1.0.0 [dest/source] (LGPL) (http://www.dovecot.org/) (<a href="http://www.dovecot.org/">http://www.dovecot.org/</a>) </li>
<li>Eudora WorldMail v2 (<a href="http://www.eudora.com/worldmail/">http://www.eudora.com/worldmail/</a>) </li>
<li>FirtClass 12 [host1] hard so read the FAQ! (<a href="http://www.firstclass.com/">http://www.firstclass.com/</a>)</li>
<li>FTGate [host1][host2] (<a href="http://www.ftgate.com/">http://www.ftgate.com/</a>)</li>
<li>Fusemail imap.fusemail.net:143 (<a href="https://www.fusemail.com/">https://www.fusemail.com/</a>).</li>
<li><b>Gimap</b> (<b>Gmail</b> imap) [host1] [host2] (<a href="http://mail.google.com/">http://mail.google.com/</a>) </li>
<li>GMX IMAP4 StreamProxy. (<a href="http://www.gmx.com/">http://www.gmx.com/</a>) </li>
<li>Godaddy IMAP (since Godaddy runs Courier) (<a href="http://www.godaddy.com/">http://www.godaddy.com/</a>) </li>
<li>Groupwise IMAP (Novell) 6.x and 7.0. Buggy so see the FAQ.
(<a href="http://www.novell.com/products/groupwise/">http://www.novell.com/products/groupwise/</a>) </li>
<li>hMailServer 5.40-B1950 [host12], 5.3.3 [host2], 4.4.1 [host1], HMAILSERVER 5.3.2-B1769 on windows 2003 [hsot2]
(<a href="http://www.hmailserver.com/">http://www.hmailserver.com/</a>) </li>
<li>IceWarp Server 10.4.5 [host1] (<a href="http://www.icewarp.com/">http://www.icewarp.com/</a>)</li>
<li>iPlanet Messaging server 4.15, 5.1, 5.2
(<a href="http://en.wikipedia.org/wiki/Oracle_Communications_Messaging_Server">http://en.wikipedia.org/wiki/Oracle_Communications_Messaging_Server</a>) </li>
<li>IMail 7.15 (Ipswitch/Win2003), 8.12, 11.03 [host1] (<a href="http://www.imailserver.com/">http://www.imailserver.com/</a>) </li>
<li>Kerio 7.2.0P1 [host1] (<a href="http://www.kerio.com/">http://www.kerio.com/</a>) </li>
<li>Mail2World IMAP4 Server 2.5 [host1] (<a href="http://www.mail2world.com/">http://www.mail2world.com/</a>)</li>
<li><b>MailEnable</b> 4.23 [host1][host2], 4.26 [host1][host2], 5 [host1]
(<a href="http://www.mailenable.com/">http://www.mailenable.com/</a>) </li>
<li>MDaemon 7.0.1, 8.0.2, 8.1, 9.5.4 (Windows server 2003 R2 platform), 9.6.5 [host1],
12 [host2], 12.0.3 [host1], 12.5.5 [host1], 13.5 [host2], 14.5 [host2]
(<a href="http://www.altn.com/">http://www.altn.com/</a>) </li>
<li>Mercury 4.1 (Windows server 2000 platform) (<a href="http://www.pmail.com/">http://www.pmail.com/</a>) </li>
<li><b>Microsoft Exchange Server</b> 5.5, 6.0.6249.0[host1], 6.0.6487.0[host1],
6.5.7638.1 [host2], 6.5 [host1], Exchange 2007 SP1 (with Update Rollup 2),
Exchange2007-EP-SP2,
Exchange 2010 RTM (Release to Manufacturing) [host2],
Exchange 2010 SP1 RU2 [host2]
(<a href="http://www.microsoft.com/exchange/">http://www.microsoft.com/exchange/</a>)
</li>
<li>Mirapoint server 4.1.9-GA [host1] (<a href="http://www.mirapoint.com/">http://www.mirapoint.com/</a>) </li>
<li>Netscape Mail Server 3.6 (Wintel) </li>
<li>Netscape Messaging Server 4.15 Patch 7 </li>
<li><b>Office 365</b> [host1] [host2] (<a href="http://office365.com">http://office365.com</a>) </li>
<li>OpenMail IMAP server B.07.00.k0 </li>
<li>OpenWave (<a href="http://www.openwave.com/">http://www.openwave.com/</a>) </li>
<li>Oracle Beehive [host1]
(<a href="http://www.oracle.com/technetwork/middleware/beehive/">http://www.oracle.com/technetwork/middleware/beehive/</a>) </li>
<li>Parallels Plesk Panel 9.x [host2] 11.x [host2] (<a href="http://www.parallels.com/">http://www.parallels.com/</a>)</li>
<li>Qualcomm Worldmail (NT) (<a href="http://www.eudora.com/worldmail/">http://www.eudora.com/worldmail/</a>) </li>
<li>Rockliffe Mailsite 5.3.11, 4.5.6 (<a href="http://www.mailsite.com/">http://www.mailsite.com/</a>) </li>
<li>RackSpace hoster secure.emailsrvr.com:993 <a href="http://www.rackspace.com/">http://www.rackspace.com/</a>)</li>
<li>QQMail IMAP4Server [host1] [host2] (See FAQ) <a href="https://en.mail.qq.com/">https://en.mail.qq.com/</a> </li>
<li>Samsung Contact IMAP server 8.5.0 </li>
<li>Scalix v10.1, 10.0.1.3, 11.0.0.431, 11.4.6 (<a href="http://www.scalix.com/">http://www.scalix.com/</a>) </li>
<li>Sendmail Mail Store IMAP4rev1 (5.5.6/mstore-5-5-build-1874 [host1].</li>
<li>SmarterMail, Smarter Mail 5.0 Enterprise, Smarter Mail 5.5 [host1], SmarterMail Professional 10.2 [host1],
Smarter Mail 11.7 [host1][host2].
(<a href="http://www.smartertools.com/">http://www.smartertools.com/</a>) </li>
<li>Softalk Workgroup Mail 7.6.4 [host1] (<a href="http://www.softalkltd.com/products/download_wm_v7.asp">http://www.softalkltd.com/products/download_wm_v7.asp</a>).</li>
<li>SunONE Messaging server 5.2, 6.0 (SUN JES - Java Enterprise System) (<a href="http://www.oracle.com/">http://www.oracle.com/</a>) </li>
<li>Sun Java(tm) System Messaging Server 6.2-2.05, 6.2-7.05, 6.3 (<a href="http://www.oracle.com/">http://www.oracle.com/</a>) </li>
<li>Surgemail 3.6f5-5, 6.3d-72 [host2] (<a href="http://netwinsite.com/surgemail/">http://netwinsite.com/surgemail/</a>) </li>
<li>UW-imap servers (imap-2000b) rijkkramer IMAP4rev1 2000.287
(RedHat uses UW like 2003.338rh), v12.264 Solaris 5.7 (OSI Approved)
(<a href="http://www.washington.edu/imap/">http://www.washington.edu/imap/</a>) </li>
<li>VMS, Imap part of TCP/IP suite of VMS 7.3.2 (<a href="http://h71000.www7.hp.com/openvms/">http://h71000.www7.hp.com/openvms/</a>) </li>
<li><b>Yahoo</b> [host1] (<a href="http://www.yahoo.com/">http://www.yahoo.com/</a>) </li>
<li>Zarafa 6,40,0,20653 [host1] (<a href="http://www.zarafa.com/">http://www.zarafa.com/</a>)</li>
<li>Zarafa ZCP 7.1.4 IMAP Gateway [host2]</li>
<li><b>Zimbra-IMAP</b> 3.0.1 GA 160, 3.1.0 Build 279, 4.0.5, 4.5.2, 4.5.6,
Zimbra 5.0.24_GA_3356.RHEL4 [host1], 5.5, 6.x
(<a href="http://www.zimbra.com/">http://www.zimbra.com/</a>) </li>
</ul>
<h2><a id="similar"></a>Similar softwares</h2>
<ul>
<li> <b>imapsync</b>: <a href="https://github.com/imapsync/imapsync">https://github.com/imapsync/imapsync</a> (imapsync copy, sometimes delayed)</li>
<li> imap_tools: <a href="http://www.athensfbc.com/imap_tools">http://www.athensfbc.com/imap_tools</a></li>
<li> imaputils: <a href="http://code.google.com/p/imaputils/">http://code.google.com/p/imaputils/</a> (imap_tools fork)</li>
<li> <b>offlineimap</b>: <a href="http://offlineimap.org/">http://offlineimap.org/</a></li>
<li> <b>mbsync</b>: <a href="http://isync.sourceforge.net/">http://isync.sourceforge.net/</a></li>
<li> mailsync: <a href="http://mailsync.sourceforge.net/">http://mailsync.sourceforge.net/</a></li>
<li> mailutil: <a href="http://www.washington.edu/imap/">http://www.washington.edu/imap/</a>
part of the UW IMAP tookit.</li>
<li> imaprepl: <a href="http://www.bl0rg.net/software/">http://www.bl0rg.net/software/</a>
<a href="http://freecode.com/projects/imap-repl/">http://freecode.com/projects/imap-repl/</a></li>
<li> imapcopy (Pascal): <a href="http://home.arcor.de/armin.diehl/imapcopy/imapcopy.html">http://home.arcor.de/armin.diehl/imapcopy/imapcopy.html</a></li>
<li> imapcopy (Java): <a href="https://code.google.com/p/imapcopy/">https://code.google.com/p/imapcopy/</a></li>
<li> migrationtool: <a href="http://sourceforge.net/projects/migrationtool/">http://sourceforge.net/projects/migrationtool/</a></li>
<li> imapmigrate: <a href="http://sourceforge.net/projects/cyrus-utils/">http://sourceforge.net/projects/cyrus-utils/</a></li>
<li> larch: <a href="https://github.com/rgrove/larch">https://github.com/rgrove/larch</a> (derived from wonko_imapsync, good at Gmail)</li>
<li> wonko_imapsync: <a href="http://web.archive.org/web/20130807173030/http://wonko.com/post/ruby_script_to_sync_email_from_any_imap_server_to_gmail">http://wonko.com/article/554</a> (superseded by larch)</li>
<li> pop2imap: <a href="http://www.linux-france.org/prj/pop2imap/">http://www.linux-france.org/prj/pop2imap/</a></li>
<li> exchange-away: <a href="http://exchange-away.sourceforge.net/">http://exchange-away.sourceforge.net/</a></li>
<li> SyncBackPro <a href="http://www.2brightsparks.com/syncback/sbpro.html">http://www.2brightsparks.com/syncback/sbpro.html</a></li>
</ul>
<h2>Online IMAP migration services</h2>
<p>I have no share in these free or paid services.
I don't think they use imapsync.
Prices are given par mailbox and may be outdated (december 2011).</p>
<ul>
<li> Ovh imapcopy (French) <b>0 USD</b>: <a href="https://ssl0.ovh.net/fr/imapcopy/">https://ssl0.ovh.net/fr/imapcopy/</a></li>
<li> Movemymail free for the first and 5 USD thereafter: <a href="https://movemymail.net">https://movemymail.net</a> .</li>
<li> Mailbox Mover 7 USD: <a href="https://mailboxmover.com/">https://mailboxmover.com/</a></li>
<li> Migrationwiz 10 USD: <a href="http://www.migrationwiz.com/">http://www.migrationwiz.com/</a></li>
<li> Rackspace migration 10 USD: <a href="http://www.rackspace.com/apps/email_hosting/migrations/">http://www.rackspace.com/apps/email_hosting/migrations/</a></li>
<li> Audriga Gmbh 9.99 EUR: <a href="https://www.email-umzug.de/en.html">https://www.email-umzug.de/</a></li>
<li> Yippiemove 15 USD: <a href="http://www.yippiemove.com">http://www.yippiemove.com/</a></li>
<li> Trueswitch 29.5 USD: <a href="http://www.trueswitch.com">http://www.trueswitch.com</a></li>
<li> Shuttlecloud <b>0 USD</b> to google apps only: <a href="http://shuttlecloud.com/solutions/#email-migration">http://shuttlecloud.com/solutions/#email-migration</a></li>
</ul>
<hr/>
<div>
@ -780,7 +448,8 @@ alt="Viewable With Any Browser" />
<!--#config timefmt="%D" -->
<!--#config timefmt="%A %B %d, %Y" -->
<b>This document last modified on <!--#echo var="LAST_MODIFIED" --></b>
($Id: index.shtml,v 1.227 2014/11/14 23:43:32 gilles Exp gilles $)
($Id: index.shtml,v 1.251 2015/03/29 17:22:13 gilles Exp gilles $)<br/>
<a href="#TOP">Top of the page</a>
</p>
</body>