iRedMail
// Document IndexThis tutorial is available in other languages. Help translate more
Attention
Check out the lightweight on-premises email archiving software developed by iRedMail team: Spider Email Archiver.
The self-signed SSL certificate generated during iRedMail installation:
on RHEL/CentOS:
/etc/pki/tls/certs/iRedMail.crt/etc/pki/tls/private/iRedMail.keyon Debian/Ubuntu:
/etc/ssl/certs/iRedMail.crt/etc/ssl/private/iRedMail.keyon FreeBSD:
/etc/ssl/certs/iRedMail.crt/etc/ssl/private/iRedMail.keyon OpenBSD:
/etc/ssl/iRedMail.crt/etc/ssl/iRedMail.keyLinux and OpenBSD, Postfix config files are placed under /etc/postfix/./usr/local/etc/postfix/.main.cf: contains most configurations.master.cf: contains transport related settings.aliases: aliases for system accounts.helo_access.pcre: PCRE regular expressions of HELO check rules.ldap/*.cf: used to query mail accounts. LDAP backends only.mysql/*.cf: used to query mail accounts. MySQL/MariaDB backends only.pgsql/*.cf: used to query mail accounts. PostgreSQL backend only./var/log/maillog./var/log/mail.log./etc/dovecot/./usr/local/etc/dovecot/.Main config file is dovecot.conf. It contains most configurations.
Additional config files under /etc/dovecot/:
dovecot-ldap.conf: used to query mail users and passwords. LDAP backends only.dovecot-mysql.conf: used to query mail users and passwords. MySQL/MariaDB backends only.dovecot-pgsql.conf: used to query mail users and passwords. PostgreSQL backend only.dovecot-used-quota.conf: used to store and query real-time per-user mailbox quota.dovecot-share-folder.conf: used to store settings of shared IMAP mailboxes.dovecot-master-users-password or dovecot-master-users: used to store Dovecot master user accounts./var/log/dovecot/*.log: main log file after iRedMail-0.9.8.Earlier releases log to /var/log/dovecot.log and /var/log/dovecot-*.log.
Linux and OpenBSD:/etc/nginx//etc/uwsgi//usr/local/etc/nginx/usr/local/www/usr/local/etc/uwsgi/Main config files are nginx.conf and default.conf.
Linux and FreeBSD: log files are placed under /var/log/nginx/./var/www/logs/ (same as Apache).Main config file:
/etc/php.ini/etc/php5/apache2/php.ini (Debian 8, Ubuntu 14.04)/etc/php/7.0/cli/php.ini (Ubuntu 16.04)/etc/php5/fpm/php.ini./etc/php5/fpm/php.ini (Debian 8, Ubuntu 14.04)/etc/php/7.0/fpm/php.ini (Ubuntu 16.04)/usr/local/etc/php.ini./etc/php-5.X.iniMain config file:
/etc/openldap/slapd.conf./etc/ldap/slapd.conf./usr/local/etc/openldap/slapd.conf./etc/openldap/slapd.conf.Schema files are stored under schema/ directory (same directory as slapd.conf).
OpenLDAP is configured to log to /var/log/openldap.log by default, if it's
empty, please check normal syslog log file /var/log/messages or
/var/log/syslog instead.
Main config file:
/etc/my.cnf./etc/mysql/my.cnf. If you're running MariaDB, it's
/etc/mysql/mariadb.conf.d/mysqld.cnf./var/db/mysql/my.cnf./etc/my.cnf.Root Directory. Roundcube webmail is installed under below directory by default:
RHEL/CentOS: /opt/www/roundcubemail. It's a symbol link to roundcubemail-x.y.z under same directory.
Note: with old iRedMail releases, it's /var/www/roundcubemail.
Debian/Ubuntu: /opt/www/roundcubemail. It's a symbol link to
/opt/www/roundcubemail-x.y.z.
Note: with old iRedMail releases, it's /usr/share/apache2/roundcubemail,
it's a symbol link to /usr/share/apache2/roundcubemail-x.y.z/.
FreeBSD: /usr/local/www/roundcube.
OpenBSD: /opt/www/roundcubemail. It's a symbol link to roundcubemail-x.y.z
under same directory.
Note: with old iRedMail releases, it's /var/www/roundcubemail.
Config files:
Main config file is config/config.inc.php under Roundcube webmail
directory.
If you're running old Roundcube webmail (0.9.x and earlier
releases), it has two separate config files: config/db.inc.php and
config/main.inc.php.
Config files of plugins are placed under plugin directory. for example,
config file of password plugin is plugins/password/config.inc.php.
Log file. Roundcube is configured to log to Postfix log file by default.
Warning
Roundcube stores all default settings in config/defaults.inc.php, please do
not modify it, instead, you should copy the settings you want to modify from
config/defaults.inc.php to config/config.inc.php, then modify the one in
config/config.inc.php.
/etc/nginx/templates/roundcube.tmpl/etc/nginx/templates/roundcube-subdomain.tmpl/etc/amavisd/amavisd.conf.on Debian/Ubuntu: it's /etc/amavis/conf.d/50-user.
Debian/Ubuntu have some additional config files under /etc/amavis/conf.d/,
but you can always override them in /etc/amavis/conf.d/50-user.
When we mention amavisd.conf in other documents, it always means 50-user
on Debian/Ubuntu.
on FreeBSD: it's /usr/local/etc/amavisd.conf.
/etc/amavisd.conf.Amavisd is configured to log to Postfix log file by iRedMail.
Attention
With default iRedMail settings, SpamAssassin is called by Amavisd, not run as a daemon.
Main config file:
/etc/mail/spamassassin/local.cf./usr/local/etc/mail/spamassassin/local.cf.SpamAssassin doesn't have a separated log file, to debug SpamAssassin, please
set $sa_debug = 1; in Amavisd config file, then restart Amavisd service.
Main config file:
/etc/fail2ban/jail.local./usr/local/etc/fail2ban/jail.local.Warning
All custom settings should be placed in jail.local, and don't touch
jail.conf, so that upgrading Fail2ban binary package won't lose/override
your custom settings.
Filters:
/etc/fail2ban/filter.d/./usr/local/etc/fail2ban/filter.d/.Ban/Unban actions:
/etc/fail2ban/action.d/./usr/local/etc/fail2ban/action.d/.Log file: Fail2ban logs to default syslog log file.
/var/log/messages./var/log/syslog./etc/sogo/sogo.conf/usr/local/etc/sogo/sogo.conf/var/log/sogo/sogo.log./opt/mlmmjadmin/settings.py (same on all Linux/BSD distributions)/var/log/mlmmjadmin/mlmmjadmin.log/var/vmail/mlmmj. Including archive./var/vmail/mlmmj-archive/opt/iredapd/settings.py on all Linux/BSD distributions.Log file:
/var/log/iredapd/iredapd.log./var/log/iredapd.log.Main config file: /opt/www/iredadmin/settings.py.
iRedAdmin is a web application, when debug mode is turned on, it will log error message to:
/var/log/uwsgi/app/iredadmin.log./var/log/messages./var/www/logs/uwsgi.log./var/log/uwsgi-iredadmin.log.Note: If you modified any iRedAdmin source files (not just config file),
don't forget to restart iredadmin service to load modified files.
Warning
Apache was dropped since iRedMail-0.9.8.
On RHEL/CentOS: Apache config files are placed under /etc/httpd/.
/etc/httpd/conf/httpd.conf./etc/httpd/conf.d/ (old releases)
or /etc/httpd/conf.modules.d/./var/www, document
root is /var/www/html/./var/www/httpd/.On Debian/Ubuntu: Apache config files are placed under /etc/apache2.
/etc/apache2/apache2.conf./etc/apache2/conf.d/ (old
releases) or /etc/apache2/conf-available/./usr/share/apache2,
document root is /var/www/ (old releases) or /var/www/html/./var/log/apache2/.On FreeBSD: Apache config files are placed under /usr/local/etc/apache2.
/usr/local/etc/apache2/httpd.conf./usr/local/etc/apache2/Includes/./usr/local/www/,
document root is /usr/local/www/apacheXX/data/./var/log/, main log files are
/var/log/httpd-access.log and /var/log/httpd-error.log.On OpenBSD: Apache (the one shipped in OpenBSD base system) config files
are placed under /var/www/conf.
/var/www/conf/httpd.conf./var/www/conf/modules/./var/www/,
document root is /var/www/htdocs/./var/www/logs/.Warning
Policyd/Cluebringer were removed since iRedMail-0.9.3.
Main config file:
/etc/policyd/cluebringer.conf, /etc/policyd/webui.conf (web admin panel)./etc/cluebringer/cluebringer.conf, /etc/cluebringer/cluebringer-webui.conf (web admin panel)./usr/local/etc/cluebringer.conf, /usr/local/etc/apache24/cluebringer.conf (web admin panel).Init script:
/etc/init.d/cbpolicyd/etc/init.d/postfix-cluebringer/usr/local/etc/rc.d/policyd2