hostname -fto view the current hostname:
$ 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
For RHEL/CentOS/Scientific Linux 7, hostname is defined in
/etc/hosts: hostname <=> IP address mapping. Warning: List the FQDN hostname as first item.
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.
$ hostname -f mx.example.com
iRedMail doesn't work with SELinux, so please disable it by setting below value in its config file
/etc/selinux/config. After server reboot, SELinux will be completely disabled.
If you prefer to let SELinux prints warnings instead of enforcing, you can set below value instead:
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 to get the latest stable release of iRedMail.
- 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 required to setup a full-featured mail server.
# cd /root/iRedMail-x.y.z/ # bash iRedMail.sh
Note to Chinese Users
Our domain name
iredmail.orghas been blocked in mainland China for years (since Jun 04, 2011), please run command below to finish the installation:
IREDMAIL_MIRROR='http://220.127.116.11' bash iRedMail.sh
Additional variables are:
- EPEL repo:
- SOGo repo:
Screenshots of installation:
- Welcome and thanks for your use
- Specify location to store all mailboxes. Default is
- Choose backend used to store mail accounts. You can manage mail accounts with iRedAdmin, our web-based iRedMail admin panel.
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.
- If you choose to store mail accounts in OpenLDAP, iRedMail installer will ask to set the LDAP suffix.
To MySQL/MariaDB/PostgreSQL users
If you choose to store mail accounts in MySQL/MariaDB/PostgreSQL, iRedMail installer will generate a random, strong password for you. You can find it in file
- Add your first mail domain name
- 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.
- Choose optional components
After answered above questions, iRedMail installer will ask you to review and confirm to start installation. It will install and configure required packages automatically. Type
/root/iRedMail-x.y.z/iRedMail.tipsfirst, it contains:
- URLs, usernames and passwords of web-based applications
- Location of mail service related software configuration files
Access webmail and other web applications
After installation successfully completed, you can access web-based programs if you choose to install them. Replace
your_serverbelow by your real server hostname or IP address.