iredmail-doc/installation/install.iredmail.on.rhel.md

# Install iRedMail on Red Hat Enterprise Linux, CentOS

[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, you need:

* A FRESH, working RHEL or CentOS system. Supported releases are listed on
  [Download](http://www.iredmail.org/download.html) page.

* At least `1 GB` of memory is required for low traffic production server.
  Spam/Virus scanning will take most system resource.

## Preparations

### Set a fully qualified domain name (FQDN) hostname on your server

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:

```shell
$ hostname -f
mx.example.com
```

On RHEL/CentOS/Scientific Linux, hostname is set in two files:

* For RHEL/CentOS/Scientific Linux 6, hostname is defined in /etc/sysconfig/network.

```
HOSTNAME=mx.example.com
```

For RHEL/CentOS/Scientific Linux 7, hostname is defined in /etc/hostname.

```
mx.example.com
```

* /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
```

Verify the FQDN hostname. If it wasn't changed, please reboot server to make it work.

```
$ hostname -f
mx.example.com
```

### Disable SELinux.

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
```

### Enable yum repositories for installing new packages

* 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.

### Download the latest release of iRedMail

* Visit [Download page](http://www.iredmail.org/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 on Tokyo, Japan.

```
# cd /root/iRedMail-x.y.z/
# bash iRedMail.sh
```

## Screenshots of installation:

1. Welcome and thanks for your use

![](http://www.iredmail.org/images/installation/iredmail/welcome.png)

2. Specify location to store all mailboxes. Default is `/var/vmail/`.

![](http://www.iredmail.org/images/installation/iredmail/location_to_store_mailboxes.png)

3. 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.

![](http://www.iredmail.org/images/installation/iredmail/backend.png)

4. If you choose to store mail accounts in OpenLDAP, iRedMail installer will
ask you two questions about OpenLDAP.

4.1. LDAP suffix.

![](http://www.iredmail.org/images/installation/iredmail/ldap_suffix.png)

4.2. Password of LDAP root dn.

![](http://www.iredmail.org/images/installation/iredmail/pw_of_ldap_root_dn.png)

5. 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.

![](http://www.iredmail.org/images/installation/iredmail/pw_of_mysql_root_user.png)

6. Add your first mail domain name

![](http://www.iredmail.org/images/installation/iredmail/first_mail_domain.png)

7. 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.

![](http://www.iredmail.org/images/installation/iredmail/pw_of_domain_admin.png)

8. Choose optional components

![](http://www.iredmail.org/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/)