iRedMail Documentation22

What is iRedMail?
iRedMail is a shell script that automatically installs and configures all necessary mail server
components on your Linux/BSD server, thus eliminating manual installation and configuration. With
iRedMail, you can easily create unlimited mailboxes and unlimited mail domains in a web-based
admin panel. Mailboxes can be stored in MariaDB/MySQL, PostgreSQL database, or OpenLDAP. The
following is a list of open-source software that will be automatically installed and configured by
iRedMail.
 Postfix SMTP server

 Dovecot IMAP server
 Nginx web server to serve the admin panel and webmail
 OpenLDAP, MySQL/MariaDB, or PostgreSQL for storing user information
 Amavised-new for DKIM signing and verification
 SpamAssassin for anti-spam
 ClamAV for anti-virus
 Roundcube webmail
 SOGo groupware, providing webmail, calendar (CalDAV), contacts (CardDAV), tasks and
ActiveSync services.
 Fail2ban for protecting SSH
 mlmmj mailing list manager
 Netdata server monitoring
 iRedAPD Postfix policy server for greylisting
Prerequisite - Requirements
 iRedMail requires at least 4 GB vCPU and 4 GB memory for a low traffic production server. If you
plan to run SOGo Groupware (which offers webmail, calendar (CalDAV), contacts (CardDAV) and
ActiveSync), you need a lot more memory. Consider 16 GB memory to support 500 ActiveSync
clients.
OS Required
Distribution Release Versions

CentOS 7, 8
Debian 9, 10
Ubuntu 18.04, 20.04
OpenBSD 6.6, 6.7
Download the latest release of iRedMail
 Visit Download page 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.gz (replace x.y.z by
the real version number).
 Uncompress iRedMail tarball:
# cd /root/
# tar zxf iRedMail-x.y.z.tar.gz
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
Screenshots of installation:
 Welcome and thanks for your use

 Specify location to store all mailboxes. Default is /var/vmail/ .
 Choose backend used to store mail accounts. You can manage mail accounts with iRedAdmin, our
web-based iRedMail admin panel.
 If you choose to store mail accounts in OpenLDAP, iRedMail installer will ask to set the LDAP suffix.
 Add your first mail domain name

 Set password of admin account of your first mail domain.
 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 y or Y and
press Enter to start.
Important things you MUST know after installation
 Read file /root/iRedMail-x.y.z/iRedMail.tips first, it contains:
o URLs, usernames and passwords of web-based applications

o Location of mail service related software configuration files. You can also check this tutorial
instead: Locations of configuration and log files of major components.
o Some other important and sensitive information
 Setup DNS records for your mail server
 How to configure your mail clients
 Locations of configuration and log files of major components
 It's highly recommended to get a SSL cert to avoid annonying warning message in web browser or
mail clients when accessing mailbox via HTTPS/IMAPS/POP3/SMTPS. Let's Encrypt offers FREE SSL
certificate. We have a document for you to use a SSL certificate.
 If you need to bulk create mail users, check our document
for OpenLDAP and MySQL/MariaDB/PostgreSQL.
 If you're running a busy mail server, we have some suggestions for better performance.
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/

 SOGo Groupware: https://your_server/SOGo
 Web admin panel (iRedAdmin): httpS://your_server/iredadmin/

iRedMail Documentation22

Uploaded by

Copyright:

Available Formats

iRedMail Documentation22

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

iRedMail Documentation22

Uploaded by

Copyright:

Available Formats

What is iRedMail?

 Postfix SMTP server

Distribution Release Versions

 Visit Download page to get the latest stable release of iRedMail.

Start iRedMail installer

 Welcome and thanks for your use

 Add your first mail domain name

 Choose optional components

Important things you MUST know after installation

 Read file /root/iRedMail-x.y.z/iRedMail.tips first, it contains:

o URLs, usernames and passwords of web-based applications

 Roundcube webmail: https://your_server/mail/

You might also like