• Requirement
• Preparation
• System Hostname
• Start iRedMail Installation
• Important Things You Should Know After Installation
• Access webmail and other web-based programs
• Trouble Shooting

Have trouble in iRedMail installation? Ask in our forum or get support from iRedMail developers.

Requirement

***************************** WARNING ********************************
* iRedMail is designed to deploy on a FRESH server system, otherwise *
* it may override your existing files/configurations althought it    *
* will backup files before modify.                                   *
***************************** WARNING ********************************

At least 512MB of memory is required for product use.

Downloading Ubuntu CD/DVD images via HTTP/FTP

Preparation

Tip: You can use exist MySQL database server to store virtual domains/users.

System Hostname

No matter your server is external or internal, strongly recommended that you set up a fully qualified domain name (FQDN) hostname.

Enter 'hostname' command to view the current hostname:

$ hostname -f
mail.iredmail.org

In Ubuntu (Hardy), hostname is set in these two files:

• /etc/hostname: hostname setting
• /etc/hosts: hostname <=> IP address mapping

# File: /etc/hostname
mail

• Map this hostname to '127.0.0.1' (Warning: List the FQDN hostname as first item.)

# File: /etc/hosts
127.0.0.1   mail.iredmail.org mail localhost localhost.localdomain

• Verify the FQDN hostname:

# hostname -f
mail.iredmail.org

• Update /etc/apt/sources.list, use default stable version. Both 'main' and 'universe' repositories are required.
• For Ubuntu 8.04 LTS (Hardy). You have to add launchpad PPA for iredmail here:

deb http://mirrors.163.com/ubuntu hardy main universe
deb http://mirrors.163.com/ubuntu hardy-updates main universe
deb http://ppa.launchpad.net/iredmail/8.04/ubuntu hardy main
#deb-src http://ppa.launchpad.net/iredmail/8.04/ubuntu hardy main

You also need import gpg key of PPA repository to your system:

# apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xd9226c1a29511386b3b9f8bc8dc2c190ddf700d3

• For Ubuntu 9.04 (Jaunty). All binary packages we need can be installed from official apt repository:

deb http://mirrors.163.com/ubuntu jaunty main universe
deb http://mirrors.163.com/ubuntu jaunty-updates main universe

• Run 'apt-get update' to update apt repository info.

# sudo apt-get update

Start iRedMail Installation

• Switch to root user, we must execute further commands as root user without sudo.

# sudo su -

• Get necessary packages. It will create a local apt repository in current directory.

# cd /path/to/iRedMail-x.y.z/pkgs/
# bash get_all.sh

• Start iRedMail installer:

# cd /path/to/iRedMail-x.y.z/
# bash iRedMail.sh

# -------------------------------------------------------
# --------------------- Generic -------------------------
# -------------------------------------------------------

Welcome page.

All emails should be stored in which directory.

iRedMail supports both OpenLDAP and MySQL as backend to store virtual domains and users. MySQL is recommended.

# -------------------------------------------------------
# ---------------- OpenLDAP Backend ---------------------
# -------------------------------------------------------

LDAP suffix, normally it's your domain name, such as:

dc=iredmail,dc=org

iRedMail will put all virtual domains/users in 'o=domains,dc=iredmail,dc=org', it's called 'LDAP base dn':

o=domains,dc=iredmail,dc=org

Set password for LDAP server admin. Admin account is defined in /etc/openldap/slapd.conf (RHEL/CentOS) or /etc/ldap/slapd.conf (Debian), normaily it's:

cn=Manager,dc=iredmail,dc=org

# --------------------------------------------------------
# ------------------- MySQL Backend ----------------------
# --------------------------------------------------------

Tip: You can use exist MySQL database server to store virtual domains/users.

Password for MySQL root user.

# --------------------------------------------------------
# ----- Generic. Creae first virtual domain and user. ----
# --------------------------------------------------------

Add your first virtual domain, e.g.:

• iredmail.org
• example.com
• domain.ltd

iRedMail will create a domain admin, default is 'postmaster@YOUR_DOMAIN', and you have to set password for it now.

Note:

• This account is used only for system administrations, not a mail user.
• You can login iRedAdmin or PostfixAdmin with this account, login name is full email address.

iRedMail will create a normal mail account, default is 'www@YOUR_DOMAIN', and you have to set password for it now.

Note:

• This account is a normal mail user.
• You can login webmail with this account, login name is full email address.

Enable SPF verify and DKIM virify/sign feature?

# --------------------------------------------------------
# -------- Optional Components for LDAP Backend ----------
# --------------------------------------------------------

# --------------------------------------------------------
# --------- Optional Components for MySQL backend --------
# --------------------------------------------------------

# --------------------------------------------------------
# -------------------- Generic Options -------------------
# --------------------------------------------------------

Set alias mail address for root user.

After you complete the configure wizard, it's time to setup mail server now:

Configuration completed.

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

After installation completed, please refer 'iRedMail-x.y.z/iRedMail.tips' file for some important information about the components you used, and you need to setup DNS record for SPF and DKIM if you choosed them.

Important Things You Should Know After Installation

• Read file 'iRedMail-x.y.z/iRedMail.tips' first, it contains:
• User password and related sensitive information.
• Location of mail serve related software configuration files and other important information.
• Setup DNS record for SPF
• Setup DNS record for DKIM

Access webmail and other web-based programs

After installation complete, you can access web-based programs if you choose to install them:

Note: Replace your_server by your server hostname or ip address.

Trouble Shooting

Please report any issue to our Issue Tracker or Forum.