2014-10-10 23:05:53 -05:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > Locations of configuration and log files of mojor components< / title >
< link href = "./css/markdown.css" rel = "stylesheet" > < / head >
< / head >
< body >
< div id = "navigation" >
< a href = "http://www.iredmail.org" target = "_blank" > iRedMail web site< / a >
// < a href = "./index.html" > Document Index< / a >
< / div > < h1 id = "locations-of-configuration-and-log-files-of-mojor-components" > Locations of configuration and log files of mojor components< / h1 >
< div class = "toc" >
< ul >
< li > < a href = "#locations-of-configuration-and-log-files-of-mojor-components" > Locations of configuration and log files of mojor components< / a > < ul >
2014-10-28 21:26:22 -06:00
< li > < a href = "#apache" > Apache< / a > < / li >
< li > < a href = "#nginx" > Nginx< / a > < / li >
2014-10-10 23:05:53 -05:00
< li > < a href = "#postfix" > Postfix< / a > < ul >
2014-10-28 21:26:22 -06:00
< li > < a href = "#main-config-files" > Main config files:< / a > < / li >
2014-10-10 23:05:53 -05:00
< li > < a href = "#log-files" > Log files< / a > < / li >
< / ul >
< / li >
< li > < a href = "#dovecot" > Dovecot< / a > < ul >
2014-10-28 21:26:22 -06:00
< li > < a href = "#config-files" > Config files< / a > < / li >
2014-10-10 23:05:53 -05:00
< li > < a href = "#log-files_1" > Log files< / a > < / li >
< / ul >
< / li >
< li > < a href = "#amavisd" > Amavisd< / a > < ul >
2014-10-28 21:26:22 -06:00
< li > < a href = "#main-config-files_1" > Main config files< / a > < / li >
2014-10-10 23:05:53 -05:00
< li > < a href = "#log-files_2" > Log files< / a > < / li >
< / ul >
< / li >
2015-01-14 03:25:16 -06:00
< li > < a href = "#fail2ban" > Fail2ban< / a > < / li >
2015-01-12 07:25:58 -06:00
< li > < a href = "#roundcube-webmail" > Roundcube webmail< / a > < / li >
2014-12-07 22:25:42 -06:00
< li > < a href = "#iredapd" > iRedAPD< / a > < / li >
< li > < a href = "#iredadmin" > iRedAdmin< / a > < / li >
2014-10-10 23:05:53 -05:00
< / ul >
< / li >
< / ul >
< / div >
2014-10-28 21:26:22 -06:00
< h2 id = "apache" > Apache< / h2 >
< ul >
< li >
2014-12-07 22:25:42 -06:00
< p > On RHEL/CentOS: Apache config files are placed under < code > /etc/httpd/< / code > .< / p >
2014-10-28 21:26:22 -06:00
< ul >
< li > Main config file is < code > /etc/httpd/conf/httpd.conf< / code > .< / li >
< li > Module config files are placed under < code > /etc/httpd/conf.d/< / code > (old releases)
or < code > /etc/httpd/conf.modules.d/< / code > .< / li >
< li > Root directory used to store web applications is < code > /var/www< / code > , document
root is < code > /var/www/html/< / code > .< / li >
< li > Log files are placed under < code > /var/www/httpd/< / code > .< / li >
< / ul >
< / li >
< li >
2014-12-07 22:25:42 -06:00
< p > On Debian/Ubuntu: Apache config files are placed under < code > /etc/apache2< / code > .< / p >
2014-10-28 21:26:22 -06:00
< ul >
< li > Main config file is < code > /etc/apache2/apache2.conf< / code > .< / li >
< li > Module config files are placed under < code > /etc/apache2/conf.d/< / code > (old
releases) or < code > /etc/apache2/conf-available/< / code > .< / li >
< li > Root directory used to store web applications is < code > /usr/share/apache2< / code > ,
document root is < code > /var/www/< / code > (old releases) or < code > /var/www/html/< / code > .< / li >
< li > Log files are placed under < code > /var/www/apache2/< / code > .< / li >
< / ul >
< / li >
< li >
2014-12-07 22:25:42 -06:00
< p > On FreeBSD: Apache config files are placed under < code > /usr/local/etc/apache2< / code > .< / p >
2014-10-28 21:26:22 -06:00
< ul >
< li > Main config file is < code > /usr/local/etc/apache2/httpd.conf< / code > .< / li >
< li > Module config files are placed under < code > /usr/local/etc/apache2/Includes/< / code > .< / li >
< li > Root directory used to store web applications is < code > /usr/local/www/< / code > ,
document root is < code > /usr/local/www/apache22/data/< / code > .< / li >
< li > Log files are placed under < code > /var/log/< / code > , main log files are
< code > /var/log/httpd-access.log< / code > and < code > /var/log/httpd-error.log< / code > .< / li >
< / ul >
< / li >
< li >
2014-12-07 22:25:42 -06:00
< p > On OpenBSD: Apache (the one shipped in OpenBSD base system) config files
2014-10-28 21:26:22 -06:00
are placed under < code > /var/www/conf< / code > .< / p >
< ul >
< li > Main config file is < code > /var/www/conf/httpd.conf< / code > .< / li >
< li > Module config files are placed under < code > /var/www/conf/modules/< / code > .< / li >
< li > Root directory used to store web applications is < code > /var/www/< / code > ,
document root is < code > /var/www/htdocs/< / code > .< / li >
< li > Log files are placed under < code > /var/www/logs/< / code > .< / li >
< / ul >
< / li >
< / ul >
< h2 id = "nginx" > Nginx< / h2 >
< ul >
2014-12-07 22:25:42 -06:00
< li > On < code > Linux< / code > and OpenBSD: Nginx config files are placed under < code > /etc/nginx/< / code > ,
2014-10-28 21:26:22 -06:00
uWSGI config files are placed under < code > /etc/uwsgi/< / code > .< / li >
2014-12-07 22:25:42 -06:00
< li > On FreeBSD: Nginx config files are placed under < code > /usr/local/etc/nginx< / code > ,
2014-10-28 21:26:22 -06:00
uWSGI config files are placed under < code > /usr/local/etc/uwsgi/< / code > .< / li >
< / ul >
< p > Main config files are < code > nginx.conf< / code > and < code > default.conf< / code > .< / p >
< ul >
2014-12-07 22:25:42 -06:00
< li > On < code > Linux< / code > and FreeBSD: log files are placed under < code > /var/log/nginx/< / code > .< / li >
< li > On OpenBSD: log files are placed under < code > /var/www/logs/< / code > (same as Apache).< / li >
2014-10-28 21:26:22 -06:00
< / ul >
2014-10-10 23:05:53 -05:00
< h2 id = "postfix" > Postfix< / h2 >
< ul >
2014-12-07 22:25:42 -06:00
< li > on < code > Linux< / code > and OpenBSD, Postfix config files are placed under < code > /etc/postfix/< / code > .< / li >
< li > on FreeBSD, Postfix config files are placed under < code > /usr/local/etc/postfix/< / code > .< / li >
2014-10-10 23:05:53 -05:00
< / ul >
2014-10-28 21:26:22 -06:00
< h3 id = "main-config-files" > Main config files:< / h3 >
2014-10-10 23:05:53 -05:00
< ul >
< li > < code > main.cf< / code > : contains most configurations.< / li >
< li > < code > master.cf< / code > : contains transport related settings.< / li >
< li > < code > aliases< / code > : aliases for system accounts.< / li >
< li > < code > helo_access.pcre< / code > : PCRE regular expressions of HELO check rules.< / li >
< li > < code > ldap/*.cf< / code > : used to query mail accounts. LDAP backends only.< / li >
< li > < code > mysql/*.cf< / code > : used to query mail accounts. MySQL/MariaDB backends only.< / li >
< li > < code > pgsql/*.cf< / code > : used to query mail accounts. PostgreSQL backend only.< / li >
< / ul >
< h3 id = "log-files" > Log files< / h3 >
< ul >
2014-12-07 22:25:42 -06:00
< li > on RHEL/CentOS, FreeBSD, OpenBSD, it's < code > /var/log/maillog< / code > .< / li >
< li > on Debian, Ubuntu, it's < code > /var/log/mail.log< / code > .< / li >
2014-10-10 23:05:53 -05:00
< / ul >
< h2 id = "dovecot" > Dovecot< / h2 >
< ul >
2014-12-07 22:25:42 -06:00
< li > on < code > Linux< / code > and OpenBSD, Dovecot config files are placed under < code > /etc/dovecot/< / code > .< / li >
< li > on FreeBSD, Dovecot config files are placed under < code > /usr/local/etc/dovecot/< / code > .< / li >
2014-10-10 23:05:53 -05:00
< / ul >
2014-10-28 21:26:22 -06:00
< h3 id = "config-files" > Config files< / h3 >
2014-10-10 23:05:53 -05:00
< p > Main config file is < code > dovecot.conf< / code > . It contains most configurations.< / p >
2015-01-12 07:25:58 -06:00
< p > Additional config files:< / p >
2014-10-10 23:05:53 -05:00
< ul >
< li > < code > dovecot-ldap.conf< / code > : used to query mail users and passwords. LDAP backends only.< / li >
< li > < code > dovecot-mysql.conf< / code > : used to query mail users and passwords. MySQL/MariaDB backends only.< / li >
< li > < code > dovecot-pgsql.conf< / code > : used to query mail users and passwords. PostgreSQL backend only.< / li >
< li > < code > dovecot-used-quota.conf< / code > : used to store and query real-time per-user mailbox quota.< / li >
< li > < code > dovecot-share-folder.conf< / code > : used to store settings of shared IMAP mailboxes.< / li >
2014-12-18 07:41:54 -06:00
< li > < code > dovecot-master-users-password< / code > or < code > dovecot-master-users< / code > : used to store Dovecot master user accounts.< / li >
2014-10-10 23:05:53 -05:00
< / ul >
< h3 id = "log-files_1" > Log files< / h3 >
< ul >
< li > < code > /var/log/dovecot.log< / code > : main log file.< / li >
< li > < code > /var/log/dovecot-sieve.log< / code > : sieve related log. NOTE: on old iRedMail
releases, it's < code > /var/log/sieve.log< / code > .< / li >
< li > < code > /var/log/dovecot-lmtp.log< / code > : LMTP related log.< / li >
< / ul >
< h2 id = "amavisd" > Amavisd< / h2 >
2014-10-28 21:26:22 -06:00
< h3 id = "main-config-files_1" > Main config files< / h3 >
2014-10-10 23:05:53 -05:00
< ul >
2014-12-07 22:25:42 -06:00
< li > on RHEL/CentOS: it's < code > /etc/amavisd/amavisd.conf< / code > .< / li >
2014-10-10 23:05:53 -05:00
< li >
2014-12-07 22:25:42 -06:00
< p > on Debian/Ubuntu: it's < code > /etc/amavis/conf.d/50-user< / code > .< / p >
2015-01-12 07:25:58 -06:00
< p > Debian/Ubuntu have some additional config files under < code > /etc/amavis/conf.d/< / code > ,
2014-12-07 22:25:42 -06:00
but you can always override them in < code > /etc/amavis/conf.d/50-user< / code > .
When we mention < code > amavisd.conf< / code > in other documents, it always means < code > 50-user< / code >
on Debian/Ubuntu.< / p >
2014-10-10 23:05:53 -05:00
< / li >
< li >
2014-12-07 22:25:42 -06:00
< p > on FreeBSD: it's < code > /usr/local/etc/amavisd.conf< / code > .< / p >
2014-10-10 23:05:53 -05:00
< / li >
2014-12-07 22:25:42 -06:00
< li > on OpenBSD: it's < code > /etc/amavisd.conf< / code > .< / li >
2014-10-10 23:05:53 -05:00
< / ul >
< h3 id = "log-files_2" > Log files< / h3 >
2014-12-07 22:25:42 -06:00
< p > Amavisd is configured to log to < a href = "#postfix" > Postfix log file< / a > by iRedMail.< / p >
2015-01-14 03:25:16 -06:00
< h2 id = "fail2ban" > Fail2ban< / h2 >
2015-02-11 04:07:26 -06:00
< ul >
< li >
2015-01-14 03:25:16 -06:00
< p > Main config file is < code > /etc/fail2ban/jail.local< / code > . All custom settings should be
2015-02-11 04:07:26 -06:00
placed in < code > /etc/fail2ban/jail.local< / code > , and don't touch < code > jail.conf< / code > , so that
upgrading Fail2ban binary package won't override your custom settings.< / p >
< / li >
< li >
< p > All filter rules are defined in files under < code > /etc/fail2ban/filters.d/< / code > .< / p >
< / li >
< li > Actions are defined in files under < code > /etc/fail2ban/actions.d/< / code > .< / li >
< / ul >
< p > FreeBSD system is < code > /usr/local/etc/fail2ban/< / code > .< / p >
2015-01-12 07:25:58 -06:00
< h2 id = "roundcube-webmail" > Roundcube webmail< / h2 >
< p > Roundcube webmail is installed under below directory by default:< / p >
< ul >
< li > RHEL/CentOS: < code > /var/www/roundcubemail< / code > . It's a symbol link to
< code > /var/www/roundcubemail-x.y.z< / code > .< / li >
< li > Debian/Ubuntu: < code > /usr/share/apache2/roundcubemail< / code > . It's a symbol link of
< code > /usr/share/apache2/roundcubemail-x.y.z/< / code > .< / li >
< li > FreeBSD: < code > /usr/local/www/roundcube< / code > .< / li >
< li > OpenBSD: < code > /var/www/roundcubemail< / code > . It's a symbol link to
< code > /var/www/roundcubemail-x.y.z/< / code > .< / li >
< / ul >
< p > Config files:< / p >
< ul >
< li >
< p > Main config file is < code > config/config.inc.php< / code > under Roundcube webmail
directory.< / p >
< p > If you're running old Roundcube webmail (0.9.x and earlier
releases), it has two separate config files: < code > config/db.inc.php< / code > and
< code > config/main.inc.php< / code > .< / p >
< / li >
< li >
< p > Config files of plugins are placed under plugin directory. for example,
config file of < code > password< / code > plugin is < code > plugins/password/config.inc.php< / code > .< / p >
< / li >
< / ul >
2014-12-07 22:25:42 -06:00
< h2 id = "iredapd" > iRedAPD< / h2 >
< p > Main config file is < code > /opt/iredapd/settings.py< / code > on all Linux/BSD distributions.< / p >
< h2 id = "iredadmin" > iRedAdmin< / h2 >
< p > Main config file:< / p >
< ul >
< li > on RHEL/CentOS, it's < code > /var/www/iredadmin/settings.py< / code > .< / li >
< li > on Debian/Ubuntu, it's < code > /usr/share/apache2/iredadmin/settings.py< / code > .< / li >
< li > on FreeBSD, it's < code > /usr/local/www/iredadmin/settings.py< / code > .< / li >
< li > on OpenBSD, it's < code > /var/www/iredadmin/settings.py< / code > .< / li >
< / ul >
< p > iRedAdmin is a web application, when debug mode is turned on, it will log error
2015-01-12 07:25:58 -06:00
message to Apache/Nginx ssl error log file.< / p >
< p > Note: If you modified any iRedAdmin files (not just config file), please restart
2015-02-05 07:02:53 -06:00
Apache or uwsgi service (if you're running Nginx) to reload modified files.< / p > < p style = "text-align: center; color: grey;" > Document published under a < a href = "http://creativecommons.org/licenses/by-nd/3.0/us/" target = "_blank" > CC BY-ND 3.0< / a > license. If you found something wrong, please do < a href = "http://www.iredmail.org/contact.html" > contact us< / a > to fix it.< script >
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
2014-10-13 19:28:43 -05:00
< / script >
< / body > < / html >
