Cheap VPS & Xen Server

Residential Proxy Network - Hourly & Monthly Packages

iRedMail 0.7.0: Open Source Mail Server With Postfix, Dovecot, Amavisd, ClamAV, SpamAssassin, RoundCube (OpenSuSE 11.4)


iRedMail is a shell script that lets you quickly deploy a full-featured mail solution in less than 2 minutes. Its object is to make a Linux mail server installation and configuration simple, painless and easy to use.

Most components used in iRedMail are provided by Linux distributions officially. It means that iRedMail users can get software update support for as long as the the distribution is supported. Since version 0.7.0, iRedMail supports OpenSuSE (it supports both i386 and x86_64). iRedMail supports both OpenLDAP and MySQL as backends for storing virtual domains and users. This tutorial shows how to use the OpenLDAP backend on OpenSuSE 11.4.

Now iRedmail provides  RoundCube as webmail, and support MySQL and OpenLDAP and can change passwords and set vacation messages.

The iRedMail project was published three years ago on 2007-11-01.

iRedAdmin is iRedMail’s official web-based admin panel for the ldap backend. You can use iRedAdmin to manage email accounts (it offers more convenience than phpldapadmin). Right now, iRedAmin supports only LDAP.

  • Main components used in this solution: http://code.google.com/p/iredmail/wiki/Main_Components
  • Discussion forum and bug report: http://www.iredmail.org/forum/
  • iRedmail FAQ: http://www.iredmail.org/faq.html
  • iRedmail Wiki: http://www.iredmail.org/wiki
  • Project home page: http://code.google.com/p/iredmail/

 

1 Requirements

It is strongly recommended to install a minimal OpenSUSE system, and then deploy the mail service via the iRedMail solution. e.g.:

To install such a system you will need the following:

  • The OpenSUSE 11.4 DVD. You can download it here: http://download.opensuse.org/distribution/11.4/iso/openSUSE-11.4-DVD-x86_64.iso
  • Internet connection.

 

2 Preliminary Note

In this tutorial we use:

  • Hostname: mail.example.com
  • IP address: 192.168.1.10 (you can set a static IP address through YaST)
  • LDAP suffix (root dn): dc=example,dc=com
  • The first virtual domain: example.com

 

3 Setting The Hostname

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

Verify the FQDN hostname:

hostname -f

mail.example.com

If it doesn’t show an FQDN, please set it with YaST.

yast lan

 

4 Start To Install iRedMail

Download the new version of iredmail, visit the download page to download the official release of iRedMail (it is recommended to use the lastest version):

# wget http://iredmail.googlecode.com/files/iRedMail-0.7.0.tar.bz2
# tar jxvf iRedMail-0.7.0.tar.bz2

Start the iRedMail installer:

# cd iRedMail-0.7.0
# bash iRedMail.sh

Note:

  • It will add some additional zypper repositories in /etc/zypp/repos.d/iRedMail.repo.
  • It will download some source packages and install the package “dialog” first.

It will show a basic GUI wizard to help you set up the mail server.

Welcome page:

iredmail_01

Choose the directory that will be used to store users’ mailboxes.

iredmail_02

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

iredmail_03

LDAP suffix, normally it’s your domain name, such as: dc=example,dc=com:

iredmail_04

Set password for LDAP server admin: cn=Manager,dc=example,dc=com

iredmail_05

Set the MySQL root password:

iredmail_06

Add your first virtual domain, e.g.:

iredmail_07

Set password for the virtual domain admin: postmaster@example.com, you can log into iRedadmin and Awstats with this account.

iredmail_08

Set password for the first normal user www@example.com for the first virtual domain:

iredmail_09

Select optional components:

iredmail_10

Select the default language for your webmail application:

iredmail_12

The configuration is now finished, we can now start the installation:

Configuration completed.

*************************************************************************
***************************** WARNING ***********************************
*************************************************************************
*                                                                       *
* Please do remember to *MOVE* configuration file after installation    *
* completed successfully.                                               *
*                                                                       *
*   * /root/iRedMail-0.7.0-beta2/config
*                                                                       *
*************************************************************************
< INFO > Continue? [Y|n]

Finish the installation:

*************************************************************************
* iRedMail-0.7.0-beta2 installation and configuration complete.
*************************************************************************

< Question > Would you like to use firewall rules shipped within iRedMail now?
< Question > File: /etc/sysconfig/SuSEfirewall2, with SSHD port: 22. [Y|n]
< Question > Restart firewall now (with SSHD port 22)? [y|N]
< INFO > Skip restart firewall.
< Question > Would you like to start postfix now? [y|N]

********************************************************************
* Congratulations, mail server setup complete. Please refer to tip
* file for more information:
*
*   – /root/iRedMail-0.7.0-beta2/iRedMail.tips
*
* And it’s sent to your mail account www@example.com.
*
* Please reboot your system to enable mail related services or start them
* manually without reboot:
*
*   # for i in syslog  apache2 postfix mysql ldap policyd dovecot
amavis clamd freshclam cron iredapd SuSEfirewall2_setup; do /etc/init.d/${i} restart; done
*
********************************************************************
* URLs of your web applications:
*
* – Webmail: http://mail.example.com/mail/ or httpS://mail.example.com/mail/
*   + Account: www@example.com, Password: iredmail
*
* – iRedAdmin: httpS://mail.example.com/iredadmin/
*   + Account: postmaster@example.com, Password: iredmail
*
* – phpMyAdmin: httpS://mail.example.com/phpmyadmin/
*   + Accounts:
*       – Name: vmailadmin, Password: SVLVELupAHB2OSqqdKgREwWci1ZZdq
*       – Name: root, Password: iredmail
*
* – phpLDAPadmin: httpS://mail.example.com/phpldapadmin/
*   + Account:
*       – Name (manage mail accounts only): cn=vmailadmin,dc=example,dc=com, Password: 6J5X7Htm8qqes70Bhzl4WHHCbevo13
*       – Name (site-wide manager): cn=Manager,dc=example,dc=com, Password: iredmail
*
* – Awstats:
*   + URLs:
*       – httpS://mail.example.com/awstats/awstats.pl?config=web
*       – httpS://mail.example.com/awstats/awstats.pl?config=smtp
*   + Account: postmaster@example.com, Password: iredmail
*
********************************************************************

Restart all the related services:

# for i in syslog apache2 postfix mysql ldap policyd dovecot amavis clamd freshclam cron iredapd SuSEfirewall2_setup; do /etc/init.d/${i} restart; done

5 Test The Mail System

5.1 Webmail RoundCube

Log into the RoundCube, use the first user www@example.com:

 

iredmail_16

The account has received two emails, read them carefully.
Note: because www@exmaple.com is a root alias, it receives system emails.

iredmail_17

5.2 iRedAdmin

Log into iRedAdmin: postmaster@example.com

iredmail_18

Dashboard:

iredmail_19

Mail Domains:

iredmail_24

Mail Users:

iredmail_25

Mail Admin:

iredmail_26

Create new mail user:

iredmail_27

Select language:

iredmail_28

5.3 phpLDAPAdmin

Log into phpLDAPAdmin: cn=manager,dc=example,dc=com

iredmail_20

Manage the mail account:

iredmail_21

5.4 Awstats

Log into Awstats: postmaster@example.com

iredmail_22

Check the statistics:

iredmail_23

6 Important Things You Should Know After Installation

  • Read the file iRedMail-x.y.z/iRedMail.tips first (iRedmail.tips example), 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
  • Enable signing disclaimer on outgoing mails

7 Access Webmail And Other Web-Based Programs

After the installation is complete, you can access web-based programs if you’ve chosen to install them:

Component URL Access via HTTP Access via HTTPS Comment
Roundcube 0.42 http://your_server/mail/ (or /webmail, /roundcube) YES YES Recommand webmail
iRedAdmin https://your_server/iredadmin NO YES Only Ldap Backend
phpMyAdmin https://your_server/phpmyadmin/ (or /mysql) NO YES
phpLDAPAdmin https://your_server/ldap/ (or /phpldapadmin) NO YES Only LDAP Backend
Awstats https://your_server/awstats/awstats.pl NO YES

Note: Replace your_server with your server hostname or IP address.

iRedAdmin, phpMyAdmin, phpLDAPAdmin and Awstats use https by default.

 

 

Comments

comments