236 lines
12 KiB
HTML
236 lines
12 KiB
HTML
<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>
|
|
<li><a href="#notes-about-binary-packages-provided-by-iredmail-project">Notes about binary packages provided by iRedMail project</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>
|
|
<p>To install iRedMail, you need:</p>
|
|
<ul>
|
|
<li>
|
|
<p>A FRESH, working RHEL or CentOS system. Supported releases are listed on
|
|
<a href="http://www.iredmail.org/download.html">Download</a> page.</p>
|
|
</li>
|
|
<li>
|
|
<p>At least <code>1 GB</code> of memory is required for low traffic production server.
|
|
Spam/Virus scanning will take most system resource.</p>
|
|
</li>
|
|
</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>
|
|
<p>No matter your server is a testing machine or production server, we strongly
|
|
recommended you to set a fully qualified domain name (FQDN) hostname.</p>
|
|
<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>
|
|
<li>/etc/hosts: hostname <=> IP address mapping. Warning: List the FQDN hostname as first item.</li>
|
|
</ul>
|
|
<pre><code>127.0.0.1 mx.example.com demo localhost localhost.localdomain
|
|
</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>
|
|
<p>Visit <a href="http://www.iredmail.org/download.html">Download page</a> to get the
|
|
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>
|
|
<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 on Tokyo, Japan.</p>
|
|
</blockquote>
|
|
<pre><code># cd /root/iRedMail-x.y.z/
|
|
# bash iRedMail.sh
|
|
</code></pre>
|
|
|
|
<h2 id="screenshots-of-installation">Screenshots of installation:</h2>
|
|
<ol>
|
|
<li>Welcome and thanks for your use</li>
|
|
</ol>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/welcome.png" /></p>
|
|
<ol>
|
|
<li>Specify location to store all mailboxes. Default is <code>/var/vmail/</code>.</li>
|
|
</ol>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/location_to_store_mailboxes.png" /></p>
|
|
<ol>
|
|
<li>Choose backend used to store mail accounts. You can manage mail accounts
|
|
with iRedAdmin, our web-based iRedMail admin panel.</li>
|
|
</ol>
|
|
<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>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/backend.png" /></p>
|
|
<ol>
|
|
<li>If you choose to store mail accounts in OpenLDAP, iRedMail installer will
|
|
ask you two questions about OpenLDAP.</li>
|
|
</ol>
|
|
<p>4.1. LDAP suffix.</p>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/ldap_suffix.png" /></p>
|
|
<p>4.2. Password of LDAP root dn.</p>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/pw_of_ldap_root_dn.png" /></p>
|
|
<ol>
|
|
<li>Set password of MySQL or PostgreSQL admin user.</li>
|
|
</ol>
|
|
<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>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/pw_of_mysql_root_user.png" /></p>
|
|
<ol>
|
|
<li>Add your first mail domain name</li>
|
|
</ol>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/first_mail_domain.png" /></p>
|
|
<ol>
|
|
<li>Set password of admin account of your first mail domain.</li>
|
|
</ol>
|
|
<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>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/pw_of_domain_admin.png" /></p>
|
|
<ol>
|
|
<li>Choose optional components</li>
|
|
</ol>
|
|
<p><img alt="" src="http://www.iredmail.org/images/installation/iredmail/optional_components.png" /></p>
|
|
<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
|
|
expected.</p>
|
|
<h2 id="notes-about-binary-packages-provided-by-iredmail-project">Notes about binary packages provided by iRedMail project</h2>
|
|
<p>Most binary packages in iRedMail yum repository comes from below repositories,
|
|
packages with <code>-ired</code> flag were packed by iRedMail project.</p>
|
|
<ul>
|
|
<li><a href="http://packages.sw.be/">Dag Wieers</a></li>
|
|
<li><a href="http://download.fedora.redhat.com/pub/epel/">EPEL</a></li>
|
|
<li><a href="http://atrpms.net/">ATrpms</a></li>
|
|
</ul><br /><p>If you found something wrong in this document, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.</p></body></html> |