2016-02-10 06:05:52 -06:00
|
|
|
# Locations of configuration and log files of major components
|
2014-10-10 23:05:53 -05:00
|
|
|
|
|
|
|
[TOC]
|
|
|
|
|
2015-12-21 08:34:13 -06:00
|
|
|
## SSL certificate
|
|
|
|
|
|
|
|
The self-signed SSL certificate generated during iRedMail installation:
|
|
|
|
|
|
|
|
* on RHEL/CentOS:
|
|
|
|
|
|
|
|
* `/etc/pki/tls/certs/iRedMail.crt`
|
|
|
|
* Private key: `/etc/pki/tls/private/iRedMail.key`
|
|
|
|
|
|
|
|
* on Debian/Ubuntu:
|
|
|
|
|
|
|
|
* `/etc/ssl/certs/iRedMail.crt`
|
|
|
|
* Private key: `/etc/ssl/private/iRedMail.key`
|
|
|
|
|
|
|
|
* on FreeBSD:
|
|
|
|
|
|
|
|
* `/etc/ssl/certs/iRedMail.crt`
|
|
|
|
* Private key: `/etc/ssl/private/iRedMail.key`
|
|
|
|
|
|
|
|
* on OpenBSD:
|
|
|
|
|
|
|
|
* `/etc/ssl/iRedMail.crt`
|
|
|
|
* Private key: `/etc/ssl/iRedMail.key`
|
|
|
|
|
2016-05-09 20:18:28 -05:00
|
|
|
## Postfix
|
|
|
|
|
|
|
|
* on `Linux` and OpenBSD, Postfix config files are placed under `/etc/postfix/`.
|
|
|
|
* on FreeBSD, Postfix config files are placed under `/usr/local/etc/postfix/`.
|
|
|
|
|
|
|
|
### Main config files:
|
|
|
|
|
|
|
|
* `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.
|
|
|
|
|
|
|
|
### Log files
|
|
|
|
|
|
|
|
* on RHEL/CentOS, FreeBSD, OpenBSD, it's `/var/log/maillog`.
|
|
|
|
* on Debian, Ubuntu, it's `/var/log/mail.log`.
|
|
|
|
|
|
|
|
## Dovecot
|
|
|
|
|
|
|
|
* on `Linux` and OpenBSD, Dovecot config files are placed under `/etc/dovecot/`.
|
|
|
|
* on FreeBSD, Dovecot config files are placed under `/usr/local/etc/dovecot/`.
|
|
|
|
|
|
|
|
### Config files
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
### Log files
|
|
|
|
|
|
|
|
* `/var/log/dovecot.log`: main log file. IMAP/POP3 sessions, login, lotout,
|
|
|
|
some error messages will be logged in this file.
|
|
|
|
* `/var/log/dovecot-sieve.log`: sieve LDA (Local Delivery Agent) related log.
|
|
|
|
Mail delivery related log will be logged in this file. NOTE: on old iRedMail
|
|
|
|
releases, it's `/var/log/sieve.log`.
|
|
|
|
* `/var/log/dovecot-lmtp.log`: LMTP related log. Mail delivery (via LMTP)
|
|
|
|
related log will be logged in this file. Note: there's no such file on
|
|
|
|
iRedMail-0.8.6 and old iRedMail releases.
|
|
|
|
|
2014-10-28 21:26:22 -06:00
|
|
|
## Apache
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* On RHEL/CentOS: Apache config files are placed under `/etc/httpd/`.
|
2014-10-28 21:26:22 -06:00
|
|
|
|
|
|
|
* Main config file is `/etc/httpd/conf/httpd.conf`.
|
|
|
|
* Module config files are placed under `/etc/httpd/conf.d/` (old releases)
|
|
|
|
or `/etc/httpd/conf.modules.d/`.
|
|
|
|
* Root directory used to store web applications is `/var/www`, document
|
|
|
|
root is `/var/www/html/`.
|
|
|
|
* Log files are placed under `/var/www/httpd/`.
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* On Debian/Ubuntu: Apache config files are placed under `/etc/apache2`.
|
2014-10-28 21:26:22 -06:00
|
|
|
|
|
|
|
* Main config file is `/etc/apache2/apache2.conf`.
|
|
|
|
* Module config files are placed under `/etc/apache2/conf.d/` (old
|
|
|
|
releases) or `/etc/apache2/conf-available/`.
|
|
|
|
* Root directory used to store web applications is `/usr/share/apache2`,
|
|
|
|
document root is `/var/www/` (old releases) or `/var/www/html/`.
|
2015-05-03 08:17:55 -05:00
|
|
|
* Log files are placed under `/var/log/apache2/`.
|
2014-10-28 21:26:22 -06:00
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* On FreeBSD: Apache config files are placed under `/usr/local/etc/apache2`.
|
2014-10-28 21:26:22 -06:00
|
|
|
|
|
|
|
* Main config file is `/usr/local/etc/apache2/httpd.conf`.
|
|
|
|
* Module config files are placed under `/usr/local/etc/apache2/Includes/`.
|
|
|
|
* Root directory used to store web applications is `/usr/local/www/`,
|
|
|
|
document root is `/usr/local/www/apache22/data/`.
|
|
|
|
* Log files are placed under `/var/log/`, main log files are
|
|
|
|
`/var/log/httpd-access.log` and `/var/log/httpd-error.log`.
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* On OpenBSD: Apache (the one shipped in OpenBSD base system) config files
|
2014-10-28 21:26:22 -06:00
|
|
|
are placed under `/var/www/conf`.
|
|
|
|
|
|
|
|
* Main config file is `/var/www/conf/httpd.conf`.
|
|
|
|
* Module config files are placed under `/var/www/conf/modules/`.
|
|
|
|
* Root directory used to store web applications is `/var/www/`,
|
|
|
|
document root is `/var/www/htdocs/`.
|
|
|
|
* Log files are placed under `/var/www/logs/`.
|
|
|
|
|
|
|
|
## Nginx
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* On `Linux` and OpenBSD: Nginx config files are placed under `/etc/nginx/`,
|
2014-10-28 21:26:22 -06:00
|
|
|
uWSGI config files are placed under `/etc/uwsgi/`.
|
2014-12-07 22:25:42 -06:00
|
|
|
* On FreeBSD: Nginx config files are placed under `/usr/local/etc/nginx`,
|
2014-10-28 21:26:22 -06:00
|
|
|
uWSGI config files are placed under `/usr/local/etc/uwsgi/`.
|
|
|
|
|
|
|
|
Main config files are `nginx.conf` and `default.conf`.
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* On `Linux` and FreeBSD: log files are placed under `/var/log/nginx/`.
|
|
|
|
* On OpenBSD: log files are placed under `/var/www/logs/` (same as Apache).
|
2014-10-28 21:26:22 -06:00
|
|
|
|
2016-05-09 20:18:28 -05:00
|
|
|
## PHP
|
2014-10-10 23:05:53 -05:00
|
|
|
|
2016-05-09 20:18:28 -05:00
|
|
|
Main config file:
|
2014-10-10 23:05:53 -05:00
|
|
|
|
2016-05-09 20:18:28 -05:00
|
|
|
* on RHEL/CentOS: it's `/etc/php.ini`
|
|
|
|
* on Debian/Ubuntu:
|
|
|
|
* If you're running Apache as web server:
|
|
|
|
* If you're running PHP-5: it's `/etc/php5/apache2/php.ini` (Debian 8, Ubuntu 14.04)
|
|
|
|
* If you're running PHP-7: it's `/etc/php/7.0/cli/php.ini` (Ubuntu 16.04)
|
|
|
|
* If you're running Nginx as web server: it's `/etc/php5/fpm/php.ini`.
|
|
|
|
* If you're running PHP-5: it's `/etc/php5/fpm/php.ini` (Debian 8, Ubuntu 14.04)
|
|
|
|
* If you're running PHP-7: it's `/etc/php/7.0/fpm/php.ini` (Ubuntu 16.04)
|
|
|
|
* on FreeBSD: it's `/usr/local/etc/php.ini`.
|
|
|
|
* on OpenBSD: it's `/etc/php-5.X.ini`
|
2014-10-10 23:05:53 -05:00
|
|
|
|
2015-02-24 08:23:40 -06:00
|
|
|
## OpenLDAP
|
|
|
|
|
|
|
|
Main config file:
|
|
|
|
|
|
|
|
* on RHEL/CentOS: it's `/etc/openldap/slapd.conf`.
|
|
|
|
* on Debian/Ubuntu: it's `/etc/ldap/slapd.conf`.
|
|
|
|
* on FreeBSD: it's `/usr/local/etc/openldap/slapd.conf`.
|
|
|
|
* on OpenBSD: it's `/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.
|
|
|
|
|
2015-05-10 04:34:55 -05:00
|
|
|
## MySQL, MariaDB
|
|
|
|
|
|
|
|
Main config file:
|
|
|
|
|
2015-10-29 08:19:56 -06:00
|
|
|
* on RHEL/CentOS: `/etc/my.cnf`.
|
2015-05-10 04:34:55 -05:00
|
|
|
* on Debian/Ubuntu, it's `/etc/mysql/my.cnf`. If you're running MariaDB, it's
|
|
|
|
`/etc/mysql/mariadb.conf.d/mysqld.cnf`.
|
|
|
|
* on FreeBSD: `/var/db/mysql/my.cnf`.
|
2015-10-29 08:19:56 -06:00
|
|
|
* on OpenBSD: `/etc/my.cnf`.
|
|
|
|
|
2016-04-28 04:39:31 -05:00
|
|
|
## Roundcube webmail
|
|
|
|
|
|
|
|
* Root Directory. Roundcube webmail is installed under below directory by default:
|
|
|
|
|
|
|
|
* RHEL/CentOS: `/var/www/roundcubemail`. It's a symbol link to
|
|
|
|
`/var/www/roundcubemail-x.y.z`.
|
2016-05-13 10:37:24 -05:00
|
|
|
* 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/`.
|
2016-04-28 04:39:31 -05:00
|
|
|
* FreeBSD: `/usr/local/www/roundcube`.
|
|
|
|
* OpenBSD: `/var/www/roundcubemail`. It's a symbol link to
|
|
|
|
`/var/www/roundcubemail-x.y.z/`.
|
|
|
|
|
|
|
|
* 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`.
|
|
|
|
|
|
|
|
!!! 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`.
|
|
|
|
|
|
|
|
* Log file. Roundcube is configured to log to [Postfix log](#postfix) file by default.
|
2015-05-10 04:34:55 -05:00
|
|
|
|
2014-10-10 23:05:53 -05:00
|
|
|
## Amavisd
|
|
|
|
|
|
|
|
### Main config files
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* on RHEL/CentOS: it's `/etc/amavisd/amavisd.conf`.
|
|
|
|
* on Debian/Ubuntu: it's `/etc/amavis/conf.d/50-user`.
|
2014-10-10 23:05:53 -05:00
|
|
|
|
2015-01-04 10:17:26 -06:00
|
|
|
Debian/Ubuntu have some additional config files under `/etc/amavis/conf.d/`,
|
2014-12-07 22:25:42 -06:00
|
|
|
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.
|
2014-10-10 23:05:53 -05:00
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
* on FreeBSD: it's `/usr/local/etc/amavisd.conf`.
|
|
|
|
* on OpenBSD: it's `/etc/amavisd.conf`.
|
2014-10-10 23:05:53 -05:00
|
|
|
|
|
|
|
### Log files
|
|
|
|
|
|
|
|
Amavisd is configured to log to [Postfix log file](#postfix) by iRedMail.
|
2014-12-07 22:25:42 -06:00
|
|
|
|
2016-04-28 04:39:31 -05:00
|
|
|
## SpamAssassin
|
2015-04-28 22:50:19 -05:00
|
|
|
|
2016-04-28 04:39:31 -05:00
|
|
|
!!! attention
|
2015-04-28 22:50:19 -05:00
|
|
|
|
2016-04-28 04:39:31 -05:00
|
|
|
With default iRedMail settings, SpamAssassin is called by Amavisd, not run as a daemon.
|
2015-04-28 22:50:19 -05:00
|
|
|
|
2016-04-28 04:39:31 -05:00
|
|
|
Main config file:
|
2015-07-14 04:15:46 -05:00
|
|
|
|
2016-04-28 04:39:31 -05:00
|
|
|
* On Linux/OpenBSD, it's `/etc/mail/spamassassin/local.cf`.
|
|
|
|
* On FreeBSD, it's `/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.
|
2015-07-14 04:15:46 -05:00
|
|
|
|
2015-01-14 03:25:16 -06:00
|
|
|
## Fail2ban
|
|
|
|
|
2016-04-28 04:46:21 -05:00
|
|
|
Main config file:
|
|
|
|
|
|
|
|
* On Linux/OpenBSD, it's `/etc/fail2ban/jail.local`.
|
|
|
|
* On FreeBSD, it's `/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:
|
|
|
|
|
|
|
|
* On Linux/OpenBSD, all filters are defined in files under `/etc/fail2ban/filter.d/`.
|
|
|
|
* On FreeBSD, all filters are defined in files under `/usr/local/etc/fail2ban/filter.d/`.
|
|
|
|
|
|
|
|
Ban/Unban actions:
|
2015-02-11 04:07:26 -06:00
|
|
|
|
2016-04-28 04:46:21 -05:00
|
|
|
* On Linux/OpenBSD, all actions are defined in files under `/etc/fail2ban/action.d/`.
|
|
|
|
* On FreeBSD, all filters are defined in files under `/usr/local/etc/fail2ban/action.d/`.
|
2015-02-11 04:07:26 -06:00
|
|
|
|
2015-01-14 03:25:16 -06:00
|
|
|
|
2015-05-08 04:55:45 -05:00
|
|
|
## SOGo Groupware
|
|
|
|
|
|
|
|
* Main config file is `/etc/sogo/sogo.conf`.
|
|
|
|
* Log file is `/var/log/sogo/sogo.log`.
|
|
|
|
|
2014-12-07 22:25:42 -06:00
|
|
|
## iRedAPD
|
|
|
|
|
2015-10-01 11:00:14 -05:00
|
|
|
* Main config file is `/opt/iredapd/settings.py` on all Linux/BSD distributions.
|
|
|
|
* Log file:
|
|
|
|
|
|
|
|
* With iRedAPD-1.7.0 and later releases, log file is `/var/log/iredapd/iredapd.log`.
|
|
|
|
* With iRedAPD-1.6.0 and older releases, log file is `/var/log/iredapd.log`.
|
2014-12-07 22:25:42 -06:00
|
|
|
|
|
|
|
## iRedAdmin
|
|
|
|
|
|
|
|
Main config file:
|
|
|
|
|
|
|
|
* on RHEL/CentOS, it's `/var/www/iredadmin/settings.py`.
|
2015-07-03 10:21:20 -05:00
|
|
|
* on Debian/Ubuntu, it's `/opt/www/iredadmin/settings.py` (in recent iRedMail
|
|
|
|
releases) or `/usr/share/apache2/iredadmin/settings.py` (in old iRedMail
|
|
|
|
releases).
|
2014-12-07 22:25:42 -06:00
|
|
|
* on FreeBSD, it's `/usr/local/www/iredadmin/settings.py`.
|
|
|
|
* on OpenBSD, it's `/var/www/iredadmin/settings.py`.
|
|
|
|
|
|
|
|
iRedAdmin is a web application, when debug mode is turned on, it will log error
|
2015-05-22 01:55:02 -05:00
|
|
|
message to [Apache ssl error log file](#apache), or uwsgi log file (if you're running
|
|
|
|
Nginx). uwsgi log file is under `/var/log/uwsgi/` on Linux/FreeBSD, and
|
|
|
|
`/var/www/logs/` on OpenBSD.
|
2015-01-12 07:25:58 -06:00
|
|
|
|
|
|
|
Note: If you modified any iRedAdmin files (not just config file), please restart
|
|
|
|
Apache or uwsgi service (if you're running Nginx) to reload modified files.
|
2016-04-28 04:39:31 -05:00
|
|
|
|
|
|
|
## <strike>Cluebringer</strike>
|
|
|
|
|
|
|
|
!!! warning
|
|
|
|
|
|
|
|
Policyd/Cluebringer were removed since iRedMail-0.9.3.
|
|
|
|
|
|
|
|
Main config file:
|
|
|
|
|
|
|
|
* RHEL/CentOS: `/etc/policyd/cluebringer.conf`, `/etc/policyd/webui.conf` (web admin panel).
|
|
|
|
* Debian/Ubuntu: `/etc/cluebringer/cluebringer.conf`, `/etc/cluebringer/cluebringer-webui.conf` (web admin panel).
|
|
|
|
* FreeBSD: `/usr/local/etc/cluebringer.conf`, `/usr/local/etc/apache24/cluebringer.conf` (web admin panel).
|
|
|
|
* OpenBSD: Not applicable, cluebringer is not available on OpenBSD.
|
|
|
|
|
|
|
|
Init script:
|
|
|
|
|
|
|
|
* RHEL/CentOS: `/etc/init.d/cbpolicyd`
|
|
|
|
* Debian/Ubuntu: `/etc/init.d/postfix-cluebringer`
|
|
|
|
* FreeBSD: `/usr/local/etc/rc.d/policyd2`
|
|
|
|
* OpenBSD: N/A. we don't have Cluebringer installed on OpenBSD.
|
|
|
|
|