mirror of
https://github.com/imapsync/imapsync.git
synced 2024-11-17 00:02:29 +01:00
210 lines
6.7 KiB
Plaintext
210 lines
6.7 KiB
Plaintext
# $Id: INSTALL.ANY.txt,v 1.62 2020/06/03 07:11:10 gilles Exp gilles $
|
|
#
|
|
# This is the main INSTALL file for imapsync.
|
|
# imapsync : IMAP sync and migrate tool.
|
|
|
|
This documentation is also located online at
|
|
https://imapsync.lamiral.info/INSTALL.d/
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.ANY.txt
|
|
|
|
=======================================================================
|
|
INTRODUCTION
|
|
=======================================================================
|
|
|
|
imapsync works fine under any operating system with Perl and Perl modules (listed below).
|
|
imapsync.exe works fine standalone under Windows XP, Vista, Seven, 20XX, either 32 or 64bit.
|
|
imapsync_64bit.exe works fine standalone under Seven, 20XX, but only 64bit.
|
|
|
|
=======================================================================
|
|
Installing imapsync on WINDOWS
|
|
=======================================================================
|
|
|
|
Read the file README_Windows.txt
|
|
Also available at
|
|
https://imapsync.lamiral.info/README_Windows.txt
|
|
|
|
|
|
=======================================================================
|
|
Installing imapsync on Unix
|
|
=======================================================================
|
|
|
|
There are specific INSTALL files in the imapsync directory INSTALL.d/
|
|
Those documents are also available at https://imapsync.lamiral.info/INSTALL.d/
|
|
|
|
- Mac OS X
|
|
- FreeBSD
|
|
- CentOS
|
|
- CPanel
|
|
- Debian
|
|
- Ubuntu
|
|
- AWS EC2
|
|
- Arch Linux
|
|
- Docker
|
|
- Online UI like /X
|
|
|
|
If you are not familiar with any of these systems but you have to chose
|
|
one to install imapsync, imapsync online, or the latest imapsync then
|
|
Centos 7 (not 8 for now) is the easiest system to consider (June 2020).
|
|
|
|
If you are not on one of these systems then read the last section
|
|
below called "Installing imapsync on other Unixes".
|
|
|
|
=======================================================================
|
|
Installing imapsync on Mac OS X
|
|
=======================================================================
|
|
|
|
Easy.
|
|
|
|
Read the file INSTALL.d/INSTALL.Darwin.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.Darwin.txt
|
|
|
|
=======================================================================
|
|
Installing imapsync on FreeBSD
|
|
=======================================================================
|
|
|
|
Easy.
|
|
|
|
Read the file INSTALL.d/INSTALL.FreeBSD.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.FreeBSD.txt
|
|
|
|
|
|
=======================================================================
|
|
Installing imapsync on CentOS
|
|
=======================================================================
|
|
|
|
Easy.
|
|
|
|
Read the file INSTALL.d/INSTALL.Centos.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.Centos.txt
|
|
|
|
|
|
=======================================================================
|
|
Installing imapsync on CPanel
|
|
=======================================================================
|
|
|
|
Easy.
|
|
|
|
Read the file INSTALL.d/INSTALL.CPanel.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.CPanel.txt
|
|
|
|
|
|
=======================================================================
|
|
Installing imapsync on Debian
|
|
=======================================================================
|
|
|
|
Not so easy.
|
|
|
|
See the file INSTALL.d/INSTALL.Debian.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.Debian.txt
|
|
|
|
=======================================================================
|
|
Installing imapsync on Ubuntu
|
|
=======================================================================
|
|
|
|
Not so easy.
|
|
|
|
See the file INSTALL.d/INSTALL.Ubuntu.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.Ubuntu.txt
|
|
|
|
=======================================================================
|
|
Installing imapsync on AWS
|
|
=======================================================================
|
|
|
|
Not so easy.
|
|
|
|
See the file INSTALL.d/INSTALL.AWS_EC2.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.AWS_EC2.txt
|
|
|
|
=======================================================================
|
|
Installing imapsync on ArchLinux
|
|
=======================================================================
|
|
|
|
Not so easy.
|
|
|
|
See the file INSTALL.d/INSTALL.ArchLinux.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.ArchLinux.txt
|
|
|
|
=======================================================================
|
|
Installing imapsync online like /X
|
|
=======================================================================
|
|
|
|
Not easy.
|
|
|
|
Follow the document INSTALL.d/INSTALL.OnlineUI.txt
|
|
This document is also available at
|
|
https://imapsync.lamiral.info/INSTALL.d/INSTALL.OnlineUI.txt
|
|
|
|
|
|
=======================================================================
|
|
Installing imapsync on other Unixes
|
|
=======================================================================
|
|
|
|
Not easy.
|
|
|
|
Purchase imapsync at
|
|
https://imapsync.lamiral.info/
|
|
or get it anywhere.
|
|
|
|
You have access to a compressed tarball called imapsync-1.xxx.tgz
|
|
where 1.xxx is the version number. Untar the tarball where
|
|
you want:
|
|
|
|
cd
|
|
tar xzvf imapsync-1.xxx.tgz
|
|
|
|
Go into the directory imapsync-1.xxx
|
|
|
|
cd imapsync-1.xxx
|
|
|
|
You can easily detect any missing Perl modules via the
|
|
script prerequisites_imapsync located in the INSTALL.d directory:
|
|
|
|
sh INSTALL.d/prerequisites_imapsync
|
|
|
|
or
|
|
|
|
cd INSTALL.d/
|
|
sh prerequisites_imapsync
|
|
|
|
You don't need to be root to run the previous command. You have
|
|
to be root if you want the Perl modules to be available for the
|
|
whole system, for all users.
|
|
|
|
You may be in one of following cases:
|
|
- you are not root.
|
|
- you are in a environment where modifying system Perl
|
|
modules can break other things or where you're not allowed to
|
|
change the whole system.
|
|
|
|
The "make" command is a prerequisite to build some Perl modules.
|
|
Install make in case it is not already installed.
|
|
|
|
Run the "cpanm" command with the missing Perl modules as arguments.
|
|
For example it can be:
|
|
|
|
cpanm Authen::NTLM Data::Uniqid File::Copy::Recursive IO::Tee \
|
|
Mail::IMAPClient Unicode::String Encode::IMAPUTF7
|
|
|
|
Once you've run the "cpanm" command, you can rerun "sh prerequisites_imapsync"
|
|
to verify everything is ok:
|
|
|
|
sh prerequisites_imapsync
|
|
|
|
When everything is ok the script execution ends with this sentence
|
|
"All needed modules are already installed"
|
|
|
|
Now imapsync should work on your system. To check it run:
|
|
|
|
./imapsync --testslive
|
|
|
|
=======================================================================
|
|
=======================================================================
|