2014-10-08 09:02:37 -05:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > Install iRedMail on Red Hat Enterprise Linux, CentOS< / title >
< link href = "./css/markdown.css" rel = "stylesheet" > < / head >
< / head >
< body >
< div id = "navigation" >
< a href = "http://www.iredmail.org" target = "_blank" > iRedMail web site< / a >
// < a href = "./index.html" > Document Index< / a >
< / div > < h1 id = "install-iredmail-on-red-hat-enterprise-linux-centos" > Install iRedMail on Red Hat Enterprise Linux, CentOS< / h1 >
< div class = "toc" >
< ul >
< li > < a href = "#install-iredmail-on-red-hat-enterprise-linux-centos" > Install iRedMail on Red Hat Enterprise Linux, CentOS< / a > < ul >
< li > < a href = "#system-requirements" > System Requirements< / a > < / li >
< li > < a href = "#preparations" > Preparations< / a > < ul >
< li > < a href = "#set-a-fully-qualified-domain-name-fqdn-hostname-on-your-server" > Set a fully qualified domain name (FQDN) hostname on your server< / a > < / li >
< li > < a href = "#disable-selinux" > Disable SELinux.< / a > < / li >
< li > < a href = "#enable-yum-repositories-for-installing-new-packages" > Enable yum repositories for installing new packages< / a > < / li >
< li > < a href = "#download-the-latest-release-of-iredmail" > Download the latest release of iRedMail< / a > < / li >
< / ul >
< / li >
< li > < a href = "#start-iredmail-installer" > Start iRedMail installer< / a > < / li >
< li > < a href = "#screenshots-of-installation" > Screenshots of installation:< / a > < / li >
< li > < a href = "#important-things-you-must-know-after-installation" > Important things you MUST know after installation< / a > < / li >
< li > < a href = "#access-webmail-and-other-web-applications" > Access webmail and other web applications< / a > < / li >
< li > < a href = "#get-technical-support" > Get technical support< / a > < / li >
< / ul >
< / li >
< / ul >
< / div >
< h2 id = "system-requirements" > System Requirements< / h2 >
< blockquote >
< p > < strong > WARNING< / strong > : iRedMail is designed to be deployed on a FRESH server system,
which means your server does < strong > NOT< / strong > 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.< / p >
< / blockquote >
2014-10-11 00:25:17 -05:00
< p > To install iRedMail on RHEL or CentOS Linux, you need:< / p >
2014-10-08 09:02:37 -05:00
< ul >
2014-10-11 00:25:17 -05:00
< li > A FRESH, working RHEL or CentOS system. Supported releases are listed on
< a href = "../download.html" > Download< / a > page.< / li >
< li > At least < code > 1 GB< / code > of memory is required for low traffic production server.
Spam/Virus scanning will take most system resource.< / li >
2014-10-08 09:02:37 -05:00
< / ul >
< h2 id = "preparations" > Preparations< / h2 >
< h3 id = "set-a-fully-qualified-domain-name-fqdn-hostname-on-your-server" > Set a fully qualified domain name (FQDN) hostname on your server< / h3 >
2014-10-11 00:25:17 -05:00
< p > No matter your server is a testing machine or production server, it's strongly
recommended to set a fully qualified domain name (FQDN) hostname.< / p >
2014-10-08 09:02:37 -05:00
< p > Enter command < code > hostname -f< / code > to view the current hostname:< / p >
< pre > < code class = "shell" > $ hostname -f
mx.example.com
< / code > < / pre >
< p > On RHEL/CentOS/Scientific Linux, hostname is set in two files:< / p >
< ul >
< li > For RHEL/CentOS/Scientific Linux 6, hostname is defined in /etc/sysconfig/network.< / li >
< / ul >
< pre > < code > HOSTNAME=mx.example.com
< / code > < / pre >
< p > For RHEL/CentOS/Scientific Linux 7, hostname is defined in /etc/hostname.< / p >
< pre > < code > mx.example.com
< / code > < / pre >
< ul >
2014-10-11 00:25:17 -05:00
< li > < code > /etc/hosts< / code > : hostname < => IP address mapping. Warning: List the FQDN hostname as first item.< / li >
2014-10-08 09:02:37 -05:00
< / ul >
2014-10-11 00:25:17 -05:00
< pre > < code > 127.0.0.1 mx.example.com mx localhost localhost.localdomain
2014-10-08 09:02:37 -05:00
< / code > < / pre >
< p > Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work.< / p >
< pre > < code > $ hostname -f
mx.example.com
< / code > < / pre >
< h3 id = "disable-selinux" > Disable SELinux.< / h3 >
< p > iRedMail doesn't work with SELinux, so please disable it by setting below
value in its config file < code > /etc/selinux/config< / code > .< / p >
< pre > < code > SELINUX=disabled
< / code > < / pre >
< p > Now disable it immediately without rebooting your server.< / p >
< pre > < code > # setenforce 0
< / code > < / pre >
< h3 id = "enable-yum-repositories-for-installing-new-packages" > Enable yum repositories for installing new packages< / h3 >
< ul >
< li >
< p > For CentOS or Scientific Linux, please enable CentOS/Scientific official
yum repositories, and < strong > DISABLE< / strong > all third-party yum repositories to
avoid package conflict.< / p >
< / li >
< li >
< p > For Red Hat Enterprise Linux, please enable Red Hat Network to install
packages, or create a local yum repository with DVD/CD ISO images.< / p >
< / li >
< / ul >
< h3 id = "download-the-latest-release-of-iredmail" > Download the latest release of iRedMail< / h3 >
< ul >
< li >
2014-10-08 21:47:39 -05:00
< p > Visit < a href = "../download.html" > Download page< / a > to get the
2014-10-08 09:02:37 -05:00
latest stable release of iRedMail.< / p >
< / li >
< li >
< p > 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 < code > /root/iRedMail-x.y.z.tar.bz2< / code > (replace x.y.z by the real version number).< / p >
< / li >
< li >
< p > Uncompress iRedMail tarball:< / p >
< / li >
< / ul >
< pre > < code > # cd /root/
# tar xjf iRedMail-x.y.z.tar.bz2
< / code > < / pre >
< h2 id = "start-iredmail-installer" > Start iRedMail installer< / h2 >
< p > 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.< / p >
< blockquote >
2014-10-10 23:05:53 -05:00
< p > 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 in Tokyo, Japan.< / p >
2014-10-08 09:02:37 -05:00
< / blockquote >
< pre > < code > # cd /root/iRedMail-x.y.z/
# bash iRedMail.sh
< / code > < / pre >
< h2 id = "screenshots-of-installation" > Screenshots of installation:< / h2 >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Welcome and thanks for your use< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/welcome.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Specify location to store all mailboxes. Default is < code > /var/vmail/< / code > .< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/location_to_store_mailboxes.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Choose backend used to store mail accounts. You can manage mail accounts
with iRedAdmin, our web-based iRedMail admin panel.< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 09:02:37 -05:00
< p > < strong > IMPORTANT NOTE< / strong > : 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.< / p >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/backend.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
< li >
< p > If you choose to store mail accounts in OpenLDAP, iRedMail installer will
ask you two questions about OpenLDAP.< / p >
< ul >
< li > LDAP suffix.< / li >
< / ul >
< / li >
< / ul >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/ldap_suffix.png" / > < / p >
2014-10-11 00:25:17 -05:00
< pre > < code > * Password of LDAP root dn.
< / code > < / pre >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/pw_of_ldap_root_dn.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Set password of MySQL or PostgreSQL admin user.< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 09:02:37 -05:00
< p > < strong > NOTE< / strong > : MySQL is used to store data of other applications (e.g. Roundcube
webmail, Cluebringer, Amavisd-new) if you choose OpenLDAP or MySQL as backend.< / p >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/pw_of_mysql_root_user.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Add your first mail domain name< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/first_mail_domain.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Set password of admin account of your first mail domain.< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 09:02:37 -05:00
< p > < strong > Note< / strong > : 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.< / p >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/pw_of_domain_admin.png" / > < / p >
2014-10-11 00:25:17 -05:00
< ul >
2014-10-08 09:02:37 -05:00
< li > Choose optional components< / li >
2014-10-11 00:25:17 -05:00
< / ul >
2014-10-08 21:47:39 -05:00
< p > < img alt = "" src = "../images/installation/iredmail/optional_components.png" / > < / p >
2014-10-08 09:02:37 -05:00
< p > After answered above questions, iRedMail installer will ask your confirm to
start installation. It will install and configure required packages
automatically. Type < code > y< / code > or < code > Y< / code > and press < code > Enter< / code > to start.< / p >
< pre > < code > 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
< / code > < / pre >
< h2 id = "important-things-you-must-know-after-installation" > Important things you < strong > MUST< / strong > know after installation< / h2 >
< ul >
< li >
< p > Read file < code > /root/iRedMail-x.y.z/iRedMail.tips< / code > first, it contains:< / p >
< ul >
< li > URLs, usernames and passwords of web-based applications< / li >
< li > Location of mail serve related software configuration files< / li >
< li > Some other important and sensitive information< / li >
< / ul >
< / li >
< li >
< p > < a href = "./setup_dns.html" > Setup DNS records for your mail server< / a > < / p >
< / li >
< / ul >
< h2 id = "access-webmail-and-other-web-applications" > Access webmail and other web applications< / h2 >
< p > After installation successfully completed, you can access web-based programs
if you choose to install them. Replace < code > your_server< / code > below by your real server
hostname or IP address.< / p >
< ul >
< li > < strong > Roundcube webmail< / strong > : < a href = "https://your_server/mail/" > https://your_server/mail/< / a > < / li >
< li > < strong > Web admin panel (iRedAdmin)< / strong > : < a href = "httpS://your_server/iredadmin/" > httpS://your_server/iredadmin/< / a > < / li >
< li > < strong > phpLDAPadmin< / strong > (available if you choose LDAP backend): < a href = "httpS://your_server/phpldapadmin/" > httpS://your_server/phpldapadmin/< / a > < / li >
< li > < strong > Awstats< / strong > : < a href = "httpS://your_server/awstats/awstats.pl?config=web" > httpS://your_server/awstats/awstats.pl?config=web< / a > (or ?config=smtp)< / li >
< / ul >
< h2 id = "get-technical-support" > Get technical support< / h2 >
< p > Please post all issues, feedbacks, feature requests, suggestions in our < a href = "http://www.iredmail.org/forum/" > online
support forum< / a > , it's more responsible than you
2014-10-11 00:25:17 -05:00
expected.< / p > < br / > < p style = "text-align: center;" > If you found something wrong
2014-10-09 22:30:58 -05:00
in this document, please do
< a href = "http://www.iredmail.org/contact.html" > contact us< / a > to fix it.< / p > < p style = "text-align: center; color: grey;" > & copy& copy Creative Commons< / p > < / body > < / html >