forked from imapsync/imapsync
-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.shtml
726 lines (571 loc) · 29.3 KB
/
index.shtml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
<?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 lang="en" id="TOP" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="application/xhtml+xml; charset=UTF-8" />
<title>Official imapsync migration tool ( release <!--#exec cmd="cat ./VERSION"--> )</title>
<meta content="WNZqC05x3b-cEYdSNrpHtgKzQrDFWHlZabhoXvfKhqM" name="google-site-verification" />
<meta content="Gilles LAMIRAL" name="author" />
<meta content="None" name="copyright" />
<meta content="imap, transfer, migration, backup" name="keywords" />
<meta content="Imapsync is an IMAP sync tool. It syncs all folders from one mailbox to another, both anywhere on the Internet or in your local network." name="description" />
<meta content="text/css" http-equiv="content-style-type" />
<link rel="canonical" href="https://imapsync.lamiral.info/" />
<link rel="icon" href="S/images/logo_imapsync_s.png" type="image/png" />
<link rel="apple-touch-icon" href="S/images/logo_imapsync_s.png" type="image/png" />
<link rel="stylesheet" href="S/style.css" type="text/css" />
<link rel="author" href="#AUTHOR" type="text/html" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<!--
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" />
-->
</head>
<body>
<div id="left-menu">
<ul class="none">
<li><a href="#WHATIS">What is imapsync?</a></li>
<li><big><big><a href="https://i005.lamiral.info/X/" title="Free full service!">Use imapsync online!</a></big></big></li>
<li><a rel="author" href="#AUTHOR">Contact the author, Gilles LAMIRAL</a></li>
<li><a href="S/testimonial.shtml">Testimonials from users</a></li>
<li><a href="#buy_all" class="larger" >Buy <b>imapsync</b> and <b>support</b></a> ( Windows + Linux + OS X + Source )</li>
<!-- <li><big><a href="http://imapsync.lamiral.info/S/guestbook.shtml">New! Give your feedback via the Guestbook!</a></big></li> -->
<li><a href="http://imapsync.lamiral.info/S/poll.shtml">Vote for a better imapsync and better services</a></li>
<li><a href="#SUPPORT">What <b>support </b></a>is given?</li>
<li><a href="#NUMBERS">Facts and figures</a></li>
<li>Examples:</li>
<li>
<ul class="none">
<li><a rel="help" href="#DOC_BASIC">How to transfer a single mailbox on Windows</a></li>
<li><a rel="help" href="#DOC_BASIC_UNIX">How to transfer a single mailbox on Unix</a></li>
<li><a rel="help" href="#DOC_MASS">How to transfer many mailboxes</a></li>
</ul>
</li>
<li><a rel="help" href="#install">Installation</a></li>
<li><a rel="help" href="#doc" class="larger" >Documentation</a></li>
<li><a href="S/news.shtml">News about imapsync <!--#exec cmd="cat ./VERSION| tr -d '\n'" -->, previous and next releases</a></li>
<li><a href="S/imapservers.shtml">List of the 81 imap software server applications <b>supported</b></a> by imapsync</li>
<li><a href="S/external.shtml">Similar software tools and external services</a></li>
<li><a href="S/mailing_list.shtml">Discuss or search on the mailing-list</a></li>
<li><a href="S/terms_and_conditions.shtml">Imapsync Terms and Conditions</a></li>
<li><a href="S/privacy_policy.shtml">Imapsync Privacy Policy</a></li>
<li><a href="#BOTTOM">Bottom of this page</a></li>
</ul>
</div>
<div class="center" id="centered-logo">
<a href="https://imapsync.lamiral.info/">
<img width="486" height="309" alt="imapsync logo" src="S/images/logo_imapsync.png" />
</a>
<h1>Time to copy all your emails and folders elsewhere!</h1>
<!-- I use SSI here only to pass a strict xhtml validation that facebook/twitter/coinbase can't pass -->
<!-- remove space before #include to activate these ssi -->
<!-- #include file="S/tw-mention.html" -->
<!-- #include file="S/fb-like.html" -->
Site last updated on <b><!--#echo var="LAST_MODIFIED" --></b><br/>
<a href="FAQ.d/FAQ.Old_Style_Web_Design.txt">Why this website looks so old fashion?</a>
</div>
<h2>What is imapsync? <a href="#TOP" id="WHATIS"><small>(back to menu)</small></a>
</h2>
<p>
<object data="https://www.youtube.com/embed/15Lz_U9qgJg"></object><br/>
Imapsync presentation by Gilles
</p>
<p>
Imapsync is an <b>IMAP transfers tool</b>.
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 used to access mailboxes,
the two other are POP3 and HTTP with webmails,
webmails are often tied to an IMAP server.
</p>
<p>Latest imapsync published release <!--#exec cmd="cat ./VERSION| tr -d '\n'" -->
was written on <!--#flastmod file="VERSION" -->
</p>
<p><b>Imapsync</b> software is a command line tool that allows incremental and
recursive <b>IMAP</b> transfers from one mailbox to another, both anywhere on the internet
or in your local network. Imapsync runs on <b>Windows</b>, <b>Linux</b>, <b>Mac OS X</b>.
"<b>Incremental</b>" means you can stop the transfer at any time
and restart it later efficiently, without generating duplicates.
"<b>Recursive</b>" means the complete folders hierarchy can be copied, all folders, all subfolders etc.
"<b>Command line</b>" means it's not a graphical tool, on Windows you have to run imapsync
from a <a href="#DOC_BASIC">batch file</a>.
Anyway there is a visual online service,
you can try imapsync online at <a href="https://i005.lamiral.info/X/">https://i005.lamiral.info/X/</a>
</p>
<p>
<b>Imapsync can't migrate Contacts and Calendars</b>.
Most email systems don't set or get Contacts or Calendars via the IMAP protocol.
No way via IMAP, no way via imapsync
but it can be done with other tools or via export/import of csv or ics files.
Also consider using <a href="http://caldavsynchronizer.org/">caldavsynchronizer</a>
or asking experts at <a href="https://twitter.com/sumatra_dev">Sumatra company</a>.
</p>
<p>
<b>imapsync</b> is not suitable for maintaining a synchronization between two active imap accounts while the user
is working on both sides.
Use <a href="http://offlineimap.org/"><b>offlineimap</b></a> (written by John Goerzen)
or <a href="http://isync.sourceforge.net/"><b>mbsync</b></a> (written by Michael R. Elkins)
for <b>bidirectionnal (2 ways) synchronizations</b>.
</p>
<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.
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,
so one of the most open license of the universe.
It is the best decision I've made about imapsync in order to continue to maintain it.
See detailed explanation and motivation here when
<a href="http://www.linux-france.org/prj/imapsync_list/msg00459.html">I looked for a business model</a>.
"Download and donate if happy" doesn't work well.
"Pay for download and I pay back if unhappy" works well, a 100 times better.
</p>
-->
<h2>Contact the author, Gilles LAMIRAL <a href="#TOP" id="AUTHOR"><small>(back to menu)</small></a>
</h2>
<div id="right-tronche">
<img width="200" height="200" src="S/images/gilles_lamiral_400x400.jpeg" alt="Gilles LAMIRAL" />
</div>
<div id="hcard_embed">
<div class="vcard" id="hcard-Gilles-LAMIRAL-Imapsync">
<div class="fn n">
<span class="given-name">Gilles</span>
<span class="family-name">LAMIRAL</span>
</div>
<div class="email"><a href="mailto:gilles@lamiral.info" class="email">gilles@lamiral.info</a>
</div>
<div class="tel">
<span class="type">work</span>
<span class="type">cel</span>: <span class="value">+33 6 19 22 03 54</span>
</div>
<div class="tel">
<span class="type">work</span>
<span class="type">desk</span>: <span class="value">+33 9 51 84 42 42</span>
</div>
<div class="adr">Postal address:
<div class="street-address">22 La Billais</div>
<span class="locality">BAULON</span>
<span class="postal-code">35580</span>
<div class="country-name">FRANCE</div>
</div>
<!--
<div class="soc">
<div class="linkedin"><a href="http://fr.linkedin.com/in/gilleslamiral" class="website">Linkedin</a></div>
<div class="twitter"><a href="https://twitter.com/imapsync" class="website">Twitter</a></div>
<div class="facebook"><a href="https://www.facebook.com/imapsync" class="website">Facebook</a></div>
<div class="google"><a href="https://plus.google.com/+GillesLamiral/" class="website">Google+</a></div>
</div>
-->
</div>
</div> <!-- ends hcard_embed -->
<p><b>Good feedback is always welcome!</b><br/>
and bad feedback is very often welcome</p>
<h2>Buy imapsync and support <a href="#TOP" id="buy_all"><small>(back to menu)</small></a>
</h2>
<blockquote class="twitter-tweet">
<p lang="en" dir="ltr">Imapsync was the best investment I've ever done.</p>
<p>— Uwe Keim
<a href="https://serverfault.com/questions/818818/imapsync-or-php-to-migrate-email">Dec 6 '16 at 12:17</a>
</p>
</blockquote>
<p>
Read some other nice and true <a href="S/testimonial.shtml">testimonials from users</a>. <br />
</p>
<p>
There is no trial version but I offer <b>30-day money back guarantee</b> whatever the
reason for a refund. Or drop me a gentle email and I will provide you the latest imapsync because,
well, you made the effort to contact me.<br />
After downloading imapsync, go to the <a href="#install">installation</a> documentation.
</p>
<p>
<big>
<b>Special</b> offer: it's only <b>€120 EUR</b> if you buy
<b>imapsync</b> + <b>support</b> at once
</big> (instead of 60 + 120 = 180 EUR).
</p>
<p>For <b>€120 EUR</b> you will get:
</p>
<ul>
<li>Imapsync <b>full professional support</b> (that costs also €120 EUR by itself, see why below).</li>
<li>Standalone <b>imapsync.exe</b> for win32, easy installation done by a zip extraction anywhere.
See <a href="README_Windows.txt">README_Windows.txt</a> for details.</li>
<li>Standalone <b>imapsync_bin_Darwin</b> for Mac OS X. (not Catalina ready because of the new signature mechanism)</li>
<li>Imapsync Perl <b>source code</b> for any operating system, Unix, Windows, OS X.</li>
<li>The <b>online visual interface</b>, like <b><a href="https://i005.lamiral.info/X/">/X</a></b>,
to install the service on a <b>Linux server</b> (not working on Windows yet).</li>
<li><b>Lifetime</b> of imapsync <b>updates</b> without extra payment.</li>
<li><b>30-day money back guarantee!</b> No question nor condition to get a refund, really, just request it and you'll sure get a refund!</li>
<li><a href="NOLIMIT" >No limit</a> to do anything with imapsync and its license.</li>
</ul>
<p>For <b>€60 EUR</b> you will get all the above except imapsync <b>full professional support</b> (the first line).
</p>
<p>
For <b>€120 EUR</b> independently, you get imapsync <b>full professional support</b>,
provided by the imapsync designer and developer, Gilles LAMIRAL, your servitor, who has
been supporting imap migrations with imapsync for more than 18 years (I started in 2001).
See a detailed <a href="#SUPPORT"><b>support description</b></a> below.
</p>
<p>
You may wonder <b>why the support alone is the same price as imapsync+support?</b> it's
because when you buy both at once, I'm not sure I will have to spend some time
directly with you, it's possible that everything will go smoothly for you;
but when you buy the support alone, after buying the software,
then I will surely spend time (any amount of hours) to help you.
Does it seem fair enough?
</p>
<form method="post" action="https://www.paypal.com/cgi-bin/webscr">
<p>
<input type="hidden" value="_s-xclick" name="cmd" />
<input type="hidden" value="H2YTURNFT4XT4" name="hosted_button_id" />
<input type="hidden" value="imapsync choice" name="on0" />
<label class="">Imapsync buying options:
<select name="os0">
<option value="Software + Support. For professional use." class="bold">Software_+_Support. For_professional_use: €120 EUR</option>
<option value="Software only. For professional use." class="bold" >Software_only.______For_professional_use: €60 EUR</option>
<option value="Support only. For professional use." class="" >Support__only.______For_professional_use: €120 EUR</option>
<option disabled="disabled" class="" >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~</option>
<option value="Software only. For individual use." class="" >Software only.______For_individual___use: €60 EUR</option>
</select>
</label>
<br />
Professionals buyers outside France are <b>VAT exempted</b>. Individuals or French buyers are <b>VAT taxed</b>.
<br />
<input type="hidden" value="VAT if professional in Europe" name="on1" />
<label>In case <b>you're a European professional</b>, please enter your <b>VAT number</b>
<input type="text" maxlength="17" size="17" name="os1" />
</label>
it is for accounting and customs declaration.<br />
VAT is often 2 letters followed by several digits, for example mine is FR74429303332.<br />
<input type="hidden" value="EUR" name="currency_code" />
<input type="image"
alt="PayPal, a safe and easy way to pay online!"
name="submit"
src="https://www.paypalobjects.com/en_US/i/btn/btn_buynowCC_LG.gif" /><br />
If you <b>can't use Paypal</b> then consider a <b><a href="#IBAN">Bank transfer</a></b>.
or a <b><a href="#crypto">Crypto</a> payment</b>.
</p>
</form>
<p>
<b>Instantly</b> at the end of the payment, Paypal will proposed you to go back to the site,
via a link to <b>gilles@lamiral.info</b> (it's my paypal account name),
this link brings you to <b>imapsync download</b>.<br />
You will also receive an email from <b>gilles@lamiral.info</b> a few minutes later
(it can fall in the Spam folder sometimes).<br />
In order to get an accurate invoice, please make sure the delivery postal address you enter in Paypal
suits your accounting department, since revised editing is not easy.<br />
Your <b>invoice</b> will be sent within <b>a few days by email</b>.
My company is identified by VAT number FR74429303332 or French SIRET number 42930333200051,
French APE/NAF number 6201Z ("programmation informatique" in French, aka, computer programming).
</p>
<h3>Support <a href="#TOP" id="SUPPORT"><small>(back to menu)</small></a>
</h3>
<p>For those of you who seek support, <b>contact me</b>, Gilles LAMIRAL, by email or phone:</p>
<ul>
<li>Email address: <b>gilles@lamiral.info</b>.</li>
<li>Desk phone number: <b>+33 9 51 84 42 42</b> located in France.</li>
<li>Mobile phone number: <b>+33 6 19 22 03 54</b> located in France (SFR operator).</li>
<li>Twitter: <a href="https://twitter.com/imapsync">https://twitter.com/imapsync</a></li>
<!--
<li>Facebook: <a href="https://www.facebook.com/imapsync">https://www.facebook.com/imapsync</a></li>
<li>Jabber address: <b>gilleslamiral@jabber.org</b></li>
<li>Google+: <a href="https://plus.google.com/+GillesLamiral/">https://plus.google.com/+GillesLamiral/</a></li>
-->
</ul>
<p>The support is done in English, <b>mostly by email</b> or possibly phone/skype.
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>,
how to deal with special imap software servers (Gmail, Office365, Exchange etc.),
choosing and explaining options, explaining error messages,
solving authentication issues,
dealing with speed, quotas, special context,
running in parallel, etc., so in summary: <b>anything!</b>
</p>
<p>
I have been supporting imap migrations with imapsync since 2001, I still enjoy it!
</p>
<h3>Payment by bank transfer and IBAN <a href="#TOP" id="IBAN"><small>(back to menu)</small></a>
</h3>
<p>If you can't pay with a credit card via Paypal then it is possible to pay via a bank transfer.
</p>
<p>Refund for a bank transfer is far less easy than with Paypal so 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 will be given upon request.
</p>
<p>
It will surely add extra work editing manually the invoice, back and forth getting good coordinates,
so I will charge both software and support normal prices for a payment via bank transfer,
that is 120 EUR.
</p>
<h3>Payment with crypto currencies, Bitcoins, Ethereum etc. <a href="#TOP" id="crypto"><small>(back to menu)</small></a>
</h3>
<div>
<a class="buy-with-crypto"
href="https://commerce.coinbase.com/checkout/5e1ad7cb-dd3d-4cda-bbf1-53d8ba94b7b6">
<span>Buy with Crypto, price equivalent €60 EUR.</span>
</a>
<script src="https://commerce.coinbase.com/v1/checkout.js"
type="text/javascript">
</script>
</div>
<!--
<div>
<a class="buy-with-crypto"
href="https://commerce.coinbase.com/checkout/d757d82d-5f54-428e-9260-90c8b032d7ce">
<span>Buy with Crypto, free price.</span>
</a>
<script src="https://commerce.coinbase.com/v1/checkout.js"
type="text/javascript">
</script>
</div>
-->
<h2>Facts and figures <a href="#TOP" id="NUMBERS"><small>(back to menu)</small></a>
</h2>
<ul>
<li><b>6000 to 7000 </b>users per month (48000 users a year).</li>
<li>11 to 16 millions mailboxes transfers per month.</li>
<li><b>159 millions</b> transfers for 2019,
that is five whole mailboxes complitely synced per second in average (159*10^6/365/24/3600),
and an estimation of 71 Petabytes ( 1 PiB = 2^50 bytes = 1024^5 ~ 10^15) transferred in total in 2019,
taking a mean of 500 Mbytes per transfer (an estimated mean given by online /X real stats).
71 Petabytes = 500*10^6*159*10^6. The global internet traffic of 2019 was 2004 Exabytes so imapsync
is a very very tiny thing (35 per million).
</li>
<li>
<b>159 millions</b> transfers for 2019.
That's nearly 717 millions email messages transferred by imapsync every day (1600*164/366)
taking a mean of 1600 messages per transfer (an estimated mean given by online /X real stats).
The internet global estimated number of messages sent every day is 300 billions in 2019
(10% being non-spam but that's another story...).
So imapsync does 0.24% of all email trafic, not that bad for a command line tool!
</li>
<li><b>Operating systems</b> run by imapsync users (in 2019):
<ul>
<li><b>Linux: 68%</b></li>
<li><b>Win32: 18%</b></li>
<li><b>Darwin: 13%</b></li>
<li><b>FreeBSD: 0.92%</b></li>
<li>OpenBSD: 0.05%</li>
<li>Solaris: 0.03%</li>
<li>Cygwin: 0%</li>
<li>Unknown: 0%</li>
<li>Other: 0%</li>
</ul>
</li>
<li><b>Highest use rate</b>: about <b>56 millions</b> of IMAP mailbox transfers by just one host.</li>
<li><b>Biggest known account</b> migrated: <b>2.4 millions folders</b> (figure independently reported).</li>
</ul>
<p>
The figures presented here do not include the github imapsync release usage.
It's because --noreleasecheck is on by default since release 1.592 (2014/05/22)
in the github release.
Looking at the numbers before and after 2014, the figures showed here
could be doubled.
</p>
<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="https://nvd.nist.gov/vuln/detail/CVE-2013-4279">CVE-2013-4279</a>.
</p>
<h2>How to transfer a single mailbox on Windows <a href="#TOP" id="DOC_BASIC"><small>(back to menu)</small></a>
</h2>
<p>
After Imapsync installation, 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 href="#TOP" id="DOC_BASIC_UNIX"><small>(back to menu)</small></a>
</h2>
<p>
After Imapsync installation, 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 href="#TOP" id="DOC_MASS"><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.<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.<br />
An example of this csv file is <b><a href="./examples/file.txt">file.txt</a></b>,
it can be used with the two previous command scripts.<br />
All example scripts can be found in the <a href="examples/">examples/*</a> directory.
</p>
<h2>Installation <a href="#TOP" id="install"><small>(back to menu)</small></a>
</h2>
<p>
Hardware system requirements:
</p>
<ul>
<li><b>500 MB of RAM</b> is ok. The mean value RAM used per imapsync process is 230 MB.</li>
<li><b>Any CPU</b> is ok.</li>
<li><b>100 MB of disk space</b> is far enough.</li>
<li><b>Any network link</b> is ok. The average bandwidth rate is 345 KiB/s ~ 2.8 Mbps.</li>
</ul>
<p>Depending on the system where you'll run imapsync:</p>
<ul>
<li>Windows users, read directly <a href="README_Windows.txt">README_Windows.txt</a>.</li>
<li>OS X users, read <a href="INSTALL.d/INSTALL.Darwin.txt">INSTALL.Darwin.txt</a>.</li>
<li>Centos users, read <a href="INSTALL.d/INSTALL.Centos.txt">INSTALL.Centos.txt</a>.</li>
<li>CPanel users, read <a href="INSTALL.d/INSTALL.CPanel.txt">INSTALL.CPanel.txt</a>.</li>
<li>Debian users, read <a href="INSTALL.d/INSTALL.Debian.txt">INSTALL.Debian.txt</a>.</li>
<li>AWS EC2 users, read <a href="INSTALL.d/INSTALL.AWS_EC2.txt">INSTALL.AWS_EC2.txt</a>.</li>
<li>Ubuntu users, read <a href="INSTALL.d/INSTALL.Ubuntu.txt">INSTALL.Ubuntu.txt</a>.</li>
<li>ArchLinux users, read <a href="INSTALL.d/INSTALL.ArchLinux.txt">INSTALL.ArchLinux.txt</a>.</li>
<li>FreeBSD users, read <a href="INSTALL.d/INSTALL.FreeBSD.txt">INSTALL.FreeBSD.txt</a>.</li>
<li>Docker users, read <a href="FAQ.d/FAQ.Docker.txt">FAQ.Docker.txt</a>
or directly the <a href="https://hub.docker.com/r/gilleslamiral/imapsync/">Imapsync Docker page</a>.</li>
<li>Online UI sysadmins, wanting their own <a href="https://i005.lamiral.info/X/">/X</a>,
read <a href="INSTALL.d/INSTALL.OnlineUI.txt">INSTALL.OnlineUI.txt</a></li>
<li>Other users, read the second part of <a href="INSTALL.d/INSTALL.ANY.txt">INSTALL.ANY.txt</a>.</li>
<li>All installation files are located in the <a href="INSTALL.d/">INSTALL.d/</a> directory.</li>
</ul>
<p>
After the imapsync installation you should go to the <a href="#doc">documentation</a> section just below.
</p>
<h2>Documentation <a href="#TOP" id="doc"><small>(back to menu)</small></a></h2>
<p>Windows users, the <a href="README_Windows.txt">README_Windows.txt</a> contains essential
knowledge to do your first syncs.
</p>
<p>Unix users, the <a href="doc/TUTORIAL_Unix.html">TUTORIAL_Unix</a> will teach you smoothly how
to do your first syncs. Windows users can read it too.
</p>
<p>The <a href="README">README</a> file contains general and specific pieces of information
to understand imapsync and succeed in your migration or backup.
</p>
<p>The <a href="FAQ.d/">FAQ.d/*</a> files present Frequently Asked Questions
(and not so frequently asked ones) and their answers. Here is the main menu:</p>
<div class="list"> Tips about imap server softwares:
<ul>
<li> <a href="FAQ.d/FAQ.Gmail.txt">Gmail accounts</a>.
See <a href="https://support.google.com/a/answer/1071518?hl=en">Gmail limits</a>. </li>
<li> <a href="FAQ.d/FAQ.Exchange.txt">Exchange 20xx and Office365</a>. </li>
<li> <a href="FAQ.d/FAQ.Yahoo.txt">Yahoo</a>. </li>
<li> <a href="FAQ.d/FAQ.Domino.txt">Domino</a>. </li>
<li> <a href="FAQ.d/FAQ.Dovecot.txt">Dovecot</a>. </li>
<li> <a href="FAQ.d/FAQ.Zimbra.txt">Zimbra</a>. </li>
<li> <a href="FAQ.d/FAQ.SmarterMail.txt">SmarterMail</a>. </li>
<li> <a href="FAQ.d/FAQ.Kerio.txt">Kerio</a>. </li>
<li> <a href="FAQ.d/FAQ.Oracle-UCS.txt">Oracle-UCS</a>. </li>
<li> <a href="FAQ.d/FAQ.David_Tobit.txt">David Tobit</a>. </li>
<li> <a href="FAQ.d/FAQ.Yandex.txt">Yandex</a>. </li>
<li> <a href="FAQ.d/FAQ.Various_Software_Servers.txt">Other various imap software servers</a>. </li>
</ul>
</div>
<div class="list">Solving problems:
<ul>
<li> <b><a href="FAQ.d/FAQ.Authentication_failure.txt">Authentication failure</a>.</b> </li>
<li> <a href="FAQ.d/FAQ.Folders_Mapping.txt">Changing folders names</a>. </li>
<li> <a href="FAQ.d/FAQ.Duplicates.txt">Duplicated messages issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Use_addheader.txt">Why use --addheader</a>? </li>
<li> <a href="FAQ.d/FAQ.Passwords_on_Windows.txt">Passwords on Windows</a>. </li>
<li> <a href="FAQ.d/FAQ.Passwords_on_Unix.txt">Passwords on Unix</a>. </li>
<li> <a href="FAQ.d/FAQ.Flags.txt">Flags issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Dates.txt">Dates issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Memory.txt">Memory issue</a>. </li>
<li> <a href="FAQ.d/FAQ.APPEND_errors.txt">Append errors</a>. </li>
<li> <a href="FAQ.d/FAQ.Messages_Too_Big.txt">How to transfer too big messages</a>. </li>
<li> <a href="FAQ.d/FAQ.Contacts_Calendars.txt">Contacts and Calendars issues</a>. </li>
<li> <a href="FAQ.d/FAQ.User_Concurrent_Access.txt">User concurrent access issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Use_cache.txt">Option --usecache and its issues</a>. </li>
<li> <a href="FAQ.d/FAQ.SSL_errors.txt">SSL errors</a>. </li>
<li> <a href="FAQ.d/FAQ.Virus.txt">Is imapsync a virus?</a>. </li>
</ul>
</div>
<div class="list">Various tips:
<ul>
<li> <a href="FAQ.d/FAQ.Migration_Plan.txt">Migration plan</a>. </li>
<li> <a href="FAQ.d/FAQ.Massive.txt">Massive/bulk migrations</a>. </li>
<li> <a href="FAQ.d/FAQ.Messages_Selection.txt">Selecting messages</a>. </li>
<li> <a href="FAQ.d/FAQ.Folders_Selection.txt">Selecting folders</a>. </li>
<li> <a href="FAQ.d/FAQ.Folders_Sizes.txt">Sizes of folders</a>. </li>
<li> <a href="FAQ.d/FAQ.Admin_Authentication.txt">Admin authentication</a>. </li>
<li> <a href="FAQ.d/FAQ.Archiving.txt">Archiving tips</a>. </li>
<li> <a href="FAQ.d/FAQ.General.txt">General FAQ</a>. </li>
<li> <a href="FAQ.d/FAQ.POP3.txt">POP3 issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Reporting_Bugs.txt">Reporting bugs</a>. </li>
<li> <a href="FAQ.d/FAQ.Big_Mailbox.txt">Big mailboxes</a>. </li>
<li> <a href="FAQ.d/FAQ.ISP.txt">ISP</a>. </li>
<li> <a href="FAQ.d/FAQ.TTL.txt">TTL</a> (MX change in DNS). </li>
<li> <a href="FAQ.d/FAQ.Security.txt">Security</a>. </li>
<li> <a href="FAQ.d/FAQ.Emptying.txt">Emptying an account</a>. </li>
<li> <a href="FAQ.d/FAQ.XOAUTH2.txt">XOAUTH2 (Gmail)</a>. </li>
<li> <a href="FAQ.d/FAQ.OnlineUI.txt">Online Visual Inferface (the web GUI /X)</a>. </li>
<li> <a href="FAQ.d/FAQ.Principles.txt">Principles and design ideas</a>. </li>
<li> <a href="FAQ.d/FAQ.GDPR.txt">GDPR</a> (General Data Protection Regulation). </li>
<li> <a href="FAQ.d/FAQ.Docker.txt">Using Docker.</a> </li>
</ul>
</div>
<p>The <a href="ChangeLog">ChangeLog</a>
to read what changed in details since 2001.</p>
<p>The <a href="TODO">TODO</a> file
lists what may be coded or done in the future.
</p>
<p>All the people I thank are in the
<a href="CREDITS">CREDITS</a> file.
</p>
<p>What you're allowed to do with imapsync is <b>"No limits to do anything with this work and this license."</b>
like written in the <a href="LICENSE">https://imapsync.lamiral.info/LICENSE</a> file (the detour is worth it).
</p>
<div id="BOTTOM">
<hr />
<a href="https://validator.w3.org/check?uri=referer"><img
alt="Valid XHTML 1.0 Strict"
src="S/images/valid-xhtml10"
width="88"
height="31"
/></a>
<a href="https://jigsaw.w3.org/css-validator/check/referer"><img
alt="CSS Valide !"
src="S/images/vcss-blue"
width="88"
height="31"
/></a>
<a href="https://www.anybrowser.org/campaign/"><img
alt="Viewable With Any Browser"
src="S/images/ab_jlh.png"
width="88"
height="31"
/></a>
</div>
<hr />
<p>
<!--#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.443 2020/01/02 23:37:20 gilles Exp gilles $)<br />
<a href="#TOP">Top of the page</a>
</p>
</body>
</html>