elmau
/
iredmail-doc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

New: install.iredmail.on.debian.md.

This commit is contained in:
Zhang Huangbin 2014-10-11 13:25:17 +08:00
parent 6c4c679146
commit 203038c89c
7 changed files with 481 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
README.md
View File

@ -1,5 +1,6 @@
* Documents are all licensed under [Creative Commons](http://creativecommons.org/). * Documents are all licensed under [Creative Commons](http://creativecommons.org/).
# Install iRedMail # Install iRedMail
* [Install iRedMail on Debian Linux](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/install.iredmail.on.debian.md)
* [Install iRedMail on Red Hat Enterprise Linux, CentOS](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/install.iredmail.on.rhel.md) * [Install iRedMail on Red Hat Enterprise Linux, CentOS](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/install.iredmail.on.rhel.md)
* [Setup DNS records for your iRedMail server](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/setup_dns.md) * [Setup DNS records for your iRedMail server](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/setup_dns.md)
* [Perform silent/unattended iRedMail installation](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/unattended.iredmail.installation.md) * [Perform silent/unattended iRedMail installation](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/unattended.iredmail.installation.md)

4
TODO.md
View File

@ -4,8 +4,8 @@
* How to enable per-recipient policy lookup in Amavisd (@lookup_sql_dsn). * How to enable per-recipient policy lookup in Amavisd (@lookup_sql_dsn).
* How to enable DNSBL in Postfix. * How to enable DNSBL in Postfix.
* How to sign DKIM signature on sent emails for new mail domain. mention how * ~~ How to sign DKIM signature on sent emails for new mail domain. mention how
to use one DKIM key for all domains. to use one DKIM key for all domains. ~~
# installation guides # installation guides

1
html/index.html
View File

@ -14,6 +14,7 @@
</ul> </ul>
<h3 id="install-iredmail">Install iRedMail</h3> <h3 id="install-iredmail">Install iRedMail</h3>
<ul> <ul>
<li><a href="install.iredmail.on.debian.html">Install iRedMail on Debian Linux</a></li>
<li><a href="install.iredmail.on.rhel.html">Install iRedMail on Red Hat Enterprise Linux, CentOS</a></li> <li><a href="install.iredmail.on.rhel.html">Install iRedMail on Red Hat Enterprise Linux, CentOS</a></li>
<li><a href="setup_dns.html">Setup DNS records for your iRedMail server</a></li> <li><a href="setup_dns.html">Setup DNS records for your iRedMail server</a></li>
<li><a href="unattended.iredmail.installation.html">Perform silent/unattended iRedMail installation</a></li> <li><a href="unattended.iredmail.installation.html">Perform silent/unattended iRedMail installation</a></li>

220
html/install.iredmail.on.debian.html Normal file
View File

@ -0,0 +1,220 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Install iRedMail on Debian Linux</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-debian-linux">Install iRedMail on Debian Linux</h1>
<div class="toc">
<ul>
<li><a href="#install-iredmail-on-debian-linux">Install iRedMail on Debian Linux</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="#enable-default-official-debian-apt-repositories">Enable default official Debian apt repositories</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 on Debian Linux, you need:</p>
<ul>
<li>A FRESH, working Debian Linux. 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>
</ul>
<p>Note: All binary packages will be installed from Debian official apt repositories.</p>
<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, it's strongly
recommended 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 Debian, hostname is set in two files: <code>/etc/hostname</code> and <code>/etc/hosts</code>.</p>
<ul>
<li><code>/etc/hostname</code>: short hostname, not FQDN.</li>
</ul>
<pre><code>mx
</code></pre>
<ul>
<li><code>/etc/hosts</code>: static table lookup for hostnames. <strong>Warning</strong>: Please list the
FQDN hostname as first item.</li>
</ul>
<pre><code># Part of file: /etc/hosts
127.0.0.1 mx.example.com mx localhost localhost.localdomain
</code></pre>
<p>Verify the FQDN hostname. If it wasn't changed after updating above two files,
please reboot server to make it work.</p>
<pre><code>$ hostname -f
mx.example.com
</code></pre>
<h3 id="enable-default-official-debian-apt-repositories">Enable default official Debian apt repositories</h3>
<ul>
<li>iRedMail needs official Debian apt repositories, please enable them in
<code>/etc/apt/sources.lists</code>.</li>
<li>Install package <code>bzip2</code> so that you can uncompress downloaded iRedMail package.</li>
</ul>
<pre><code># sudo apt-get install bzip2
</code></pre>
<h3 id="download-the-latest-release-of-iredmail">Download the latest release of iRedMail</h3>
<ul>
<li>
<p>Visit <a href="../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 in 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>
<ul>
<li>Welcome and thanks for your use</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/welcome.png" /></p>
<ul>
<li>Specify location to store all mailboxes. Default is <code>/var/vmail/</code>.</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/location_to_store_mailboxes.png" /></p>
<ul>
<li>Choose backend used to store mail accounts. You can manage mail accounts
with iRedAdmin, our web-based iRedMail admin panel.</li>
</ul>
<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="../images/installation/iredmail/backend.png" /></p>
<ul>
<li>If you choose to store mail accounts in OpenLDAP, iRedMail installer will
ask you two questions about OpenLDAP.</li>
</ul>
<p>LDAP suffix.</p>
<p><img alt="" src="../images/installation/iredmail/ldap_suffix.png" /></p>
<p>Password of LDAP root dn.</p>
<p><img alt="" src="../images/installation/iredmail/pw_of_ldap_root_dn.png" /></p>
<ul>
<li>Set password of MySQL or PostgreSQL admin user.</li>
</ul>
<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="../images/installation/iredmail/pw_of_mysql_root_user.png" /></p>
<ul>
<li>Add your first mail domain name</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/first_mail_domain.png" /></p>
<ul>
<li>Set password of admin account of your first mail domain.</li>
</ul>
<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="../images/installation/iredmail/pw_of_domain_admin.png" /></p>
<ul>
<li>Choose optional components</li>
</ul>
<p><img alt="" src="../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
* *
*************************************************************************
&lt;&lt;&lt; iRedMail &gt;&gt;&gt; Continue? [Y|n] # &lt;- 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 style="text-align: center;">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><p style="text-align: center; color: grey;">&copy&copy Creative Commons</p></body></html>

78
html/install.iredmail.on.rhel.html
View File

@ -27,7 +27,6 @@
<li><a href="#important-things-you-must-know-after-installation">Important things you MUST know after 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="#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="#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> </ul>
</li> </li>
</ul> </ul>
@ -41,21 +40,17 @@ and configure them for you automatically. Otherwise it may override your
existing files/configurations althought it will backup files before modifing, existing files/configurations althought it will backup files before modifing,
and it may be not working as expected.</p> and it may be not working as expected.</p>
</blockquote> </blockquote>
<p>To install iRedMail, you need:</p> <p>To install iRedMail on RHEL or CentOS Linux, you need:</p>
<ul> <ul>
<li> <li>A FRESH, working RHEL or CentOS system. Supported releases are listed on
<p>A FRESH, working RHEL or CentOS system. Supported releases are listed on <a href="../download.html">Download</a> page.</li>
<a href="../download.html">Download</a> page.</p> <li>At least <code>1 GB</code> of memory is required for low traffic production server.
</li> Spam/Virus scanning will take most system resource.</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> </ul>
<h2 id="preparations">Preparations</h2> <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> <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 <p>No matter your server is a testing machine or production server, it's strongly
recommended you to set a fully qualified domain name (FQDN) hostname.</p> recommended to set a fully qualified domain name (FQDN) hostname.</p>
<p>Enter command <code>hostname -f</code> to view the current hostname:</p> <p>Enter command <code>hostname -f</code> to view the current hostname:</p>
<pre><code class="shell">$ hostname -f <pre><code class="shell">$ hostname -f
mx.example.com mx.example.com
@ -73,9 +68,9 @@ mx.example.com
</code></pre> </code></pre>
<ul> <ul>
<li>/etc/hosts: hostname &lt;=&gt; IP address mapping. Warning: List the FQDN hostname as first item.</li> <li><code>/etc/hosts</code>: hostname &lt;=&gt; IP address mapping. Warning: List the FQDN hostname as first item.</li>
</ul> </ul>
<pre><code>127.0.0.1 mx.example.com demo localhost localhost.localdomain <pre><code>127.0.0.1 mx.example.com mx localhost localhost.localdomain
</code></pre> </code></pre>
<p>Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work.</p> <p>Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work.</p>
@ -135,50 +130,55 @@ questions, that's all steps to setup a full-featured mail server.</p>
</code></pre> </code></pre>
<h2 id="screenshots-of-installation">Screenshots of installation:</h2> <h2 id="screenshots-of-installation">Screenshots of installation:</h2>
<ol> <ul>
<li>Welcome and thanks for your use</li> <li>Welcome and thanks for your use</li>
</ol> </ul>
<p><img alt="" src="../images/installation/iredmail/welcome.png" /></p> <p><img alt="" src="../images/installation/iredmail/welcome.png" /></p>
<ol> <ul>
<li>Specify location to store all mailboxes. Default is <code>/var/vmail/</code>.</li> <li>Specify location to store all mailboxes. Default is <code>/var/vmail/</code>.</li>
</ol> </ul>
<p><img alt="" src="../images/installation/iredmail/location_to_store_mailboxes.png" /></p> <p><img alt="" src="../images/installation/iredmail/location_to_store_mailboxes.png" /></p>
<ol> <ul>
<li>Choose backend used to store mail accounts. You can manage mail accounts <li>Choose backend used to store mail accounts. You can manage mail accounts
with iRedAdmin, our web-based iRedMail admin panel.</li> with iRedAdmin, our web-based iRedMail admin panel.</li>
</ol> </ul>
<p><strong>IMPORTANT NOTE</strong>: There's no big difference between available backends, so <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 it's strongly recommended to choose the one you're familiar with for easier
management and maintenance after installation.</p> management and maintenance after installation.</p>
<p><img alt="" src="../images/installation/iredmail/backend.png" /></p> <p><img alt="" src="../images/installation/iredmail/backend.png" /></p>
<ol> <ul>
<li>If you choose to store mail accounts in OpenLDAP, iRedMail installer will <li>
ask you two questions about OpenLDAP.</li> <p>If you choose to store mail accounts in OpenLDAP, iRedMail installer will
</ol> ask you two questions about OpenLDAP.</p>
<p>4.1. LDAP suffix.</p> <ul>
<li>LDAP suffix.</li>
</ul>
</li>
</ul>
<p><img alt="" src="../images/installation/iredmail/ldap_suffix.png" /></p> <p><img alt="" src="../images/installation/iredmail/ldap_suffix.png" /></p>
<p>4.2. Password of LDAP root dn.</p> <pre><code>* Password of LDAP root dn.
</code></pre>
<p><img alt="" src="../images/installation/iredmail/pw_of_ldap_root_dn.png" /></p> <p><img alt="" src="../images/installation/iredmail/pw_of_ldap_root_dn.png" /></p>
<ol> <ul>
<li>Set password of MySQL or PostgreSQL admin user.</li> <li>Set password of MySQL or PostgreSQL admin user.</li>
</ol> </ul>
<p><strong>NOTE</strong>: MySQL is used to store data of other applications (e.g. Roundcube <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> webmail, Cluebringer, Amavisd-new) if you choose OpenLDAP or MySQL as backend.</p>
<p><img alt="" src="../images/installation/iredmail/pw_of_mysql_root_user.png" /></p> <p><img alt="" src="../images/installation/iredmail/pw_of_mysql_root_user.png" /></p>
<ol> <ul>
<li>Add your first mail domain name</li> <li>Add your first mail domain name</li>
</ol> </ul>
<p><img alt="" src="../images/installation/iredmail/first_mail_domain.png" /></p> <p><img alt="" src="../images/installation/iredmail/first_mail_domain.png" /></p>
<ol> <ul>
<li>Set password of admin account of your first mail domain.</li> <li>Set password of admin account of your first mail domain.</li>
</ol> </ul>
<p><strong>Note</strong>: This account is an admin account and a mail user. That means you can <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 login to webmail and admin panel (iRedAdmin) with this account, login username
is full email address.</p> is full email address.</p>
<p><img alt="" src="../images/installation/iredmail/pw_of_domain_admin.png" /></p> <p><img alt="" src="../images/installation/iredmail/pw_of_domain_admin.png" /></p>
<ol> <ul>
<li>Choose optional components</li> <li>Choose optional components</li>
</ol> </ul>
<p><img alt="" src="../images/installation/iredmail/optional_components.png" /></p> <p><img alt="" src="../images/installation/iredmail/optional_components.png" /></p>
<p>After answered above questions, iRedMail installer will ask your confirm to <p>After answered above questions, iRedMail installer will ask your confirm to
start installation. It will install and configure required packages start installation. It will install and configure required packages
@ -225,14 +225,6 @@ hostname or IP address.</p>
<h2 id="get-technical-support">Get technical support</h2> <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 <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 support forum</a>, it's more responsible than you
expected.</p> expected.</p><br /><p style="text-align: center;">If you found something wrong
<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 style="text-align: center;">If you found something wrong
in this document, please do 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> <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>

207
installation/install.iredmail.on.debian.md Normal file
View File

@ -0,0 +1,207 @@
# Install iRedMail on Debian Linux
[TOC]
## System Requirements
> __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 on Debian Linux, you need:
* A FRESH, working Debian Linux. Supported releases are listed on
[Download](../download.html) page.
* At least `1 GB` of memory is required for low traffic production server.
Spam/Virus scanning will take most system resource.
Note: All binary packages will be installed from Debian official apt repositories.
## Preparations
### Set a fully qualified domain name (FQDN) hostname on your server
No matter your server is a testing machine or production server, it's strongly
recommended to set a fully qualified domain name (FQDN) hostname.
Enter command `hostname -f` to view the current hostname:
```shell
$ hostname -f
mx.example.com
```
On Debian, hostname is set in two files: `/etc/hostname` and `/etc/hosts`.
* `/etc/hostname`: short hostname, not FQDN.
```
mx
```
* `/etc/hosts`: static table lookup for hostnames. __Warning__: Please list the
FQDN hostname as first item.
```
# Part of file: /etc/hosts
127.0.0.1 mx.example.com mx localhost localhost.localdomain
```
Verify the FQDN hostname. If it wasn't changed after updating above two files,
please reboot server to make it work.
```
$ hostname -f
mx.example.com
```
### Enable default official Debian apt repositories
* iRedMail needs official Debian apt repositories, please enable them in
`/etc/apt/sources.lists`.
* Install package `bzip2` so that you can uncompress downloaded iRedMail package.
```
# sudo apt-get install bzip2
```
### Download the latest release of iRedMail
* Visit [Download page](../download.html) 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
```
## Start iRedMail installer
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 in Tokyo, Japan.
```
# cd /root/iRedMail-x.y.z/
# bash iRedMail.sh
```
## Screenshots of installation:
* Welcome and thanks for your use
![](../images/installation/iredmail/welcome.png)
* Specify location to store all mailboxes. Default is `/var/vmail/`.
![](../images/installation/iredmail/location_to_store_mailboxes.png)
* Choose backend used to store mail accounts. You can manage mail accounts
with iRedAdmin, our web-based iRedMail admin panel.
__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.
![](../images/installation/iredmail/backend.png)
* If you choose to store mail accounts in OpenLDAP, iRedMail installer will
ask you two questions about OpenLDAP.
LDAP suffix.
![](../images/installation/iredmail/ldap_suffix.png)
Password of LDAP root dn.
![](../images/installation/iredmail/pw_of_ldap_root_dn.png)
* Set password of MySQL or PostgreSQL admin user.
__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.
![](../images/installation/iredmail/pw_of_mysql_root_user.png)
* Add your first mail domain name
![](../images/installation/iredmail/first_mail_domain.png)
* Set password of admin account of your first mail domain.
__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.
![](../images/installation/iredmail/pw_of_domain_admin.png)
* Choose optional components
![](../images/installation/iredmail/optional_components.png)
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
```
## Important things you __MUST__ know after installation
* Read file `/root/iRedMail-x.y.z/iRedMail.tips` first, it contains:
* URLs, usernames and passwords of web-based applications
* Location of mail serve related software configuration files
* Some other important and sensitive information
* [Setup DNS records for your mail server](./setup_dns.html)
## Access webmail and other web applications
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.
* __Roundcube webmail__: [https://your_server/mail/](https://your_server/mail/)
* __Web admin panel (iRedAdmin)__: [httpS://your_server/iredadmin/](httpS://your_server/iredadmin/)
* __phpLDAPadmin__ (available if you choose LDAP backend): [httpS://your_server/phpldapadmin/](httpS://your_server/phpldapadmin/)
* __Awstats__: [httpS://your_server/awstats/awstats.pl?config=web](httpS://your_server/awstats/awstats.pl?config=web) (or ?config=smtp)
## Get technical support
Please post all issues, feedbacks, feature requests, suggestions in our [online
support forum](http://www.iredmail.org/forum/), it's more responsible than you
expected.
## Notes about binary packages provided by iRedMail project
Most binary packages in iRedMail yum repository comes from below repositories,
packages with `-ired` flag were packed by iRedMail project.
* [Dag Wieers](http://packages.sw.be/)
* [EPEL](http://download.fedora.redhat.com/pub/epel/)
* [ATrpms](http://atrpms.net/)

40
installation/install.iredmail.on.rhel.md
View File

@ -11,11 +11,10 @@
> existing files/configurations althought it will backup files before modifing, > existing files/configurations althought it will backup files before modifing,
> and it may be not working as expected. > and it may be not working as expected.
To install iRedMail, you need: To install iRedMail on RHEL or CentOS Linux, you need:
* A FRESH, working RHEL or CentOS system. Supported releases are listed on * A FRESH, working RHEL or CentOS system. Supported releases are listed on
[Download](../download.html) page. [Download](../download.html) page.
* At least `1 GB` of memory is required for low traffic production server. * At least `1 GB` of memory is required for low traffic production server.
Spam/Virus scanning will take most system resource. Spam/Virus scanning will take most system resource.
@ -23,8 +22,8 @@ To install iRedMail, you need:
### Set a fully qualified domain name (FQDN) hostname on your server ### Set a fully qualified domain name (FQDN) hostname on your server
No matter your server is a testing machine or production server, we strongly No matter your server is a testing machine or production server, it's strongly
recommended you to set a fully qualified domain name (FQDN) hostname. recommended to set a fully qualified domain name (FQDN) hostname.
Enter command `hostname -f` to view the current hostname: Enter command `hostname -f` to view the current hostname:
@ -47,10 +46,10 @@ For RHEL/CentOS/Scientific Linux 7, hostname is defined in /etc/hostname.
mx.example.com mx.example.com
``` ```
* /etc/hosts: hostname <=> IP address mapping. Warning: List the FQDN hostname as first item. * `/etc/hosts`: hostname <=> IP address mapping. Warning: List the FQDN hostname as first item.
``` ```
127.0.0.1 mx.example.com demo localhost localhost.localdomain 127.0.0.1 mx.example.com mx localhost localhost.localdomain
``` ```
Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work. Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work.
@ -114,15 +113,15 @@ questions, that's all steps to setup a full-featured mail server.
## Screenshots of installation: ## Screenshots of installation:
1. Welcome and thanks for your use * Welcome and thanks for your use
![](../images/installation/iredmail/welcome.png) ![](../images/installation/iredmail/welcome.png)
2. Specify location to store all mailboxes. Default is `/var/vmail/`. * Specify location to store all mailboxes. Default is `/var/vmail/`.
![](../images/installation/iredmail/location_to_store_mailboxes.png) ![](../images/installation/iredmail/location_to_store_mailboxes.png)
3. Choose backend used to store mail accounts. You can manage mail accounts * Choose backend used to store mail accounts. You can manage mail accounts
with iRedAdmin, our web-based iRedMail admin panel. with iRedAdmin, our web-based iRedMail admin panel.
__IMPORTANT NOTE__: There's no big difference between available backends, so __IMPORTANT NOTE__: There's no big difference between available backends, so
@ -131,29 +130,29 @@ management and maintenance after installation.
![](../images/installation/iredmail/backend.png) ![](../images/installation/iredmail/backend.png)
4. If you choose to store mail accounts in OpenLDAP, iRedMail installer will * If you choose to store mail accounts in OpenLDAP, iRedMail installer will
ask you two questions about OpenLDAP. ask you two questions about OpenLDAP.
4.1. LDAP suffix. * LDAP suffix.
![](../images/installation/iredmail/ldap_suffix.png) ![](../images/installation/iredmail/ldap_suffix.png)
4.2. Password of LDAP root dn. * Password of LDAP root dn.
![](../images/installation/iredmail/pw_of_ldap_root_dn.png) ![](../images/installation/iredmail/pw_of_ldap_root_dn.png)
5. Set password of MySQL or PostgreSQL admin user. * Set password of MySQL or PostgreSQL admin user.
__NOTE__: MySQL is used to store data of other applications (e.g. Roundcube __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. webmail, Cluebringer, Amavisd-new) if you choose OpenLDAP or MySQL as backend.
![](../images/installation/iredmail/pw_of_mysql_root_user.png) ![](../images/installation/iredmail/pw_of_mysql_root_user.png)
6. Add your first mail domain name * Add your first mail domain name
![](../images/installation/iredmail/first_mail_domain.png) ![](../images/installation/iredmail/first_mail_domain.png)
7. Set password of admin account of your first mail domain. * Set password of admin account of your first mail domain.
__Note__: This account is an admin account and a mail user. That means you can __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 login to webmail and admin panel (iRedAdmin) with this account, login username
@ -161,7 +160,7 @@ is full email address.
![](../images/installation/iredmail/pw_of_domain_admin.png) ![](../images/installation/iredmail/pw_of_domain_admin.png)
8. Choose optional components * Choose optional components
![](../images/installation/iredmail/optional_components.png) ![](../images/installation/iredmail/optional_components.png)
@ -212,12 +211,3 @@ hostname or IP address.
Please post all issues, feedbacks, feature requests, suggestions in our [online Please post all issues, feedbacks, feature requests, suggestions in our [online
support forum](http://www.iredmail.org/forum/), it's more responsible than you support forum](http://www.iredmail.org/forum/), it's more responsible than you
expected. expected.
## Notes about binary packages provided by iRedMail project
Most binary packages in iRedMail yum repository comes from below repositories,
packages with `-ired` flag were packed by iRedMail project.
* [Dag Wieers](http://packages.sw.be/)
* [EPEL](http://download.fedora.redhat.com/pub/epel/)
* [ATrpms](http://atrpms.net/)