![Zhang Huangbin](/assets/img/avatar_default.png)
Update iRedAdmin-Pro RESTful API (able to manage standalone domain admins). Update iRedMail upgrade tutorial.
336 lines
12 KiB
Markdown
336 lines
12 KiB
Markdown
# Locations of configuration and log files of major components
|
|
|
|
[TOC]
|
|
|
|
## SSL certificate {: #ssl }
|
|
|
|
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`
|
|
|
|
## Postfix {: #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: {: #postfix-config }
|
|
|
|
* `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 {: #postfix-log }
|
|
|
|
* on RHEL/CentOS, FreeBSD, OpenBSD, it's `/var/log/maillog`.
|
|
* on Debian, Ubuntu, it's `/var/log/mail.log`.
|
|
|
|
## Dovecot {: #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 {: #dovecot-config }
|
|
|
|
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 {: #dovecot-log }
|
|
|
|
* `/var/log/dovecot.log`: main log file.
|
|
|
|
* Since iRedMail-0.9.6, on Linux:
|
|
* `/var/log/dovecot-imap.log`: IMAP service related log.
|
|
* `/var/log/dovecot-pop3.log`: POP3 service related log.
|
|
* `/var/log/dovecot-sieve.log`: Managesieve service related log.
|
|
* `/var/log/dovecot-lda.log`: Local mail delivery related log, including both sieve and LMTP.
|
|
|
|
* In iRedMail-0.9.5 and earlier versions, all Linux and BSD system:
|
|
* `/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.
|
|
|
|
## Apache {: #apache }
|
|
|
|
* On RHEL/CentOS: Apache config files are placed under `/etc/httpd/`.
|
|
|
|
* 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/`.
|
|
|
|
* On Debian/Ubuntu: Apache config files are placed under `/etc/apache2`.
|
|
|
|
* 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/`.
|
|
* Log files are placed under `/var/log/apache2/`.
|
|
|
|
* On FreeBSD: Apache config files are placed under `/usr/local/etc/apache2`.
|
|
|
|
* 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`.
|
|
|
|
* On OpenBSD: Apache (the one shipped in OpenBSD base system) config files
|
|
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 {: #nginx }
|
|
|
|
* On `Linux` and OpenBSD: Nginx config files are placed under `/etc/nginx/`,
|
|
uWSGI config files are placed under `/etc/uwsgi/`.
|
|
* On FreeBSD: Nginx config files are placed under `/usr/local/etc/nginx`,
|
|
uWSGI config files are placed under `/usr/local/etc/uwsgi/`.
|
|
|
|
Main config files are `nginx.conf` and `default.conf`.
|
|
|
|
* 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).
|
|
|
|
## PHP {: #php }
|
|
|
|
Main config file:
|
|
|
|
* 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`
|
|
|
|
## OpenLDAP {: #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.
|
|
|
|
## MySQL, MariaDB {: #mysql }
|
|
|
|
Main config file:
|
|
|
|
* on RHEL/CentOS: `/etc/my.cnf`.
|
|
* 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`.
|
|
* on OpenBSD: `/etc/my.cnf`.
|
|
|
|
## Roundcube webmail {: #roundcube }
|
|
|
|
* 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`.
|
|
* 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: `/var/www/roundcubemail`. It's a symbol link to
|
|
`/var/www/roundcubemail-x.y.z/`.
|
|
|
|
* Config files:
|
|
{: #roundcube-config }
|
|
|
|
* 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](#postfix) file by default.
|
|
{: #roundcube-log }
|
|
|
|
!!! 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`.
|
|
|
|
## Amavisd {: #amavisd }
|
|
|
|
### Main config files {: #amavisd-config }
|
|
|
|
* on RHEL/CentOS: it's `/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`.
|
|
* on OpenBSD: it's `/etc/amavisd.conf`.
|
|
|
|
### Log files {: #amavisd-log }
|
|
|
|
Amavisd is configured to log to [Postfix log file](#postfix) by iRedMail.
|
|
|
|
## SpamAssassin {: #spamassassin }
|
|
|
|
!!! attention
|
|
|
|
With default iRedMail settings, SpamAssassin is called by Amavisd, not run as a daemon.
|
|
|
|
Main config file:
|
|
{: #spamassassin-config }
|
|
|
|
* 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.
|
|
{: #spamassassin-log }
|
|
|
|
## Fail2ban {: #fail2ban }
|
|
|
|
Main config file:
|
|
{: #fail2ban-config }
|
|
|
|
* 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:
|
|
|
|
* 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/`.
|
|
|
|
Log file: Fail2ban logs to default syslog log file.
|
|
{: #fail2ban-log }
|
|
|
|
* on RHEL/CentOS/OpenBSD/FreeBSD, it's `/var/log/messages`.
|
|
* on Debian/Ubuntu, it's `/var/log/syslog`.
|
|
|
|
## SOGo Groupware {: #sogo }
|
|
|
|
* Main config file is
|
|
* on Linux/OpenBSD: `/etc/sogo/sogo.conf`
|
|
* on FreeBSD: `/usr/local/etc/sogo/sogo.conf`
|
|
* Log file is `/var/log/sogo/sogo.log`.
|
|
|
|
## iRedAPD {: #iredapd }
|
|
|
|
* 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`.
|
|
|
|
## iRedAdmin {: #iredadmin }
|
|
|
|
Main config file:
|
|
|
|
* on RHEL/CentOS, it's `/var/www/iredadmin/settings.py`.
|
|
* 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).
|
|
* 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
|
|
message to:
|
|
|
|
* If you're running Apache, it logs to [Apache ssl error log file](#apache).
|
|
* If you're running Nginx with uwsgi:
|
|
* on Debian/Ubuntu, it logs to `/var/log/uwsgi/app/iredadmin.log`.
|
|
* on RHEL/CentOS, it logs to `/var/log/messages`.
|
|
* on OpenBSD, it logs to `/var/www/logs/uwsgi.log`.
|
|
* on FreeBSD, it logs to `/var/log/uwsgi-iredadmin.log`.
|
|
|
|
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.
|
|
|
|
## <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.
|
|
|