We're working on migrating old wiki documents to Markdown format for easier maintenance, you can find converted documents here.
++WARNING: iRedMail is designed to be deployed on a FRESH server system, +which means your server does NOT have mail related components installed, +e.g. MySQL, OpenLDAP, Postfix, Dovecot, Amavisd, etc. iRedMail will install +and configure them for you automatically. Otherwise it may override your +existing files/configurations althought it will backup files before modifing, +and it may be not working as expected.
+
To install iRedMail, you need:
+A FRESH, working RHEL or CentOS system. Supported releases are listed on + Download page.
+At least 1 GB of memory is required for low traffic production server.
+ Spam/Virus scanning will take most system resource.
No matter your server is a testing machine or production server, we strongly +recommended you to set a fully qualified domain name (FQDN) hostname.
+Enter command hostname -f to view the current hostname:
$ hostname -f
+mx.example.com
+On RHEL/CentOS/Scientific Linux, hostname is set in two files:
+HOSTNAME=mx.example.com
+For RHEL/CentOS/Scientific Linux 7, hostname is defined in /etc/hostname.
+mx.example.com
+127.0.0.1 mx.example.com demo localhost localhost.localdomain
+Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work.
+$ hostname -f
+mx.example.com
+iRedMail doesn't work with SELinux, so please disable it by setting below
+value in its config file /etc/selinux/config.
SELINUX=disabled
+Now disable it immediately without rebooting your server.
+# setenforce 0
+For CentOS or Scientific Linux, please enable CentOS/Scientific official + yum repositories, and DISABLE all third-party yum repositories to + avoid package conflict.
+For Red Hat Enterprise Linux, please enable Red Hat Network to install + packages, or create a local yum repository with DVD/CD ISO images.
+Visit Download page to get the + latest stable release of iRedMail.
+Upload iRedMail to your mail server via ftp or scp or whatever method you
+ can use, login to the server to install iRedMail. We assume you uploaded
+ it to /root/iRedMail-x.y.z.tar.bz2 (replace x.y.z by the real version number).
Uncompress iRedMail tarball:
+# cd /root/
+# tar xjf iRedMail-x.y.z.tar.bz2
+It's now ready to start iRedMail installer, it will ask you several simple +questions, that's all steps to setup a full-featured mail server.
+++For Chinese users: Our domain name "iredmail.org" is blocked in China mainland since Jun 04, 2011, please replace all 'iredmail.org' by its IP address "106.187.51.47" (without quotes) in /root/iRedMail-x.y.z/pkgs/get_all.sh BEFORE executing "iRedMail.sh". This is a Linode VPS hosted on Tokyo, Japan.
+
# cd /root/iRedMail-x.y.z/
+# bash iRedMail.sh
+
/var/vmail/.
IMPORTANT NOTE: There's no big difference between available backends, so +it's strongly recommended to choose the one you're familiar with for easier +management and maintenance after installation.
+
4.1. LDAP suffix.
+
4.2. Password of LDAP root dn.
+
NOTE: MySQL is used to store data of other applications (e.g. Roundcube +webmail, Cluebringer, Amavisd-new) if you choose OpenLDAP or MySQL as backend.
+
Note: This account is an admin account and a mail user. That means you can +login to webmail and admin panel (iRedAdmin) with this account, login username +is full email address.
+
After answered above questions, iRedMail installer will ask your confirm to
+start installation. It will install and configure required packages
+automatically. Type y or Y and press Enter to start.
Configuration completed.
+
+*************************************************************************
+**************************** WARNING ***********************************
+*************************************************************************
+* *
+* Please do remember to *REMOVE* configuration file after installation *
+* completed successfully. *
+* *
+* * /root/iRedMail-x.y.z/config
+* *
+*************************************************************************
+<<< iRedMail >>> Continue? [Y|n] # <- Type 'Y' or 'y' here, and press 'Enter' to continue
+Read file /root/iRedMail-x.y.z/iRedMail.tips first, it contains:
After installation successfully completed, you can access web-based programs
+if you choose to install them. Replace your_server below by your real server
+hostname or IP address.
Please post all issues, feedbacks, feature requests, suggestions in our online +support forum, it's more responsible than you +expected.
+Most binary packages in iRedMail yum repository comes from below repositories,
+packages with -ired flag were packed by iRedMail project.
If you found something wrong in this document, please do contact us to fix it.