diff --git a/docs/firststeps-syslog.md b/docs/firststeps-syslog.md deleted file mode 100644 index 06687506e..000000000 --- a/docs/firststeps-syslog.md +++ /dev/null @@ -1,78 +0,0 @@ -Enable Rsyslog to receive logs on 524/tcp at `rsyslog.conf`: - -``` -# This setting depends on your Rsyslog version and configuration format. -# For most Debian derivates it will work like this... -$ModLoad imtcp -$TCPServerAddress 127.0.0.1 -$InputTCPServerRun 524 - -# ...while for Ubuntu 16.04 it looks like this: -module(load="imtcp") -input(type="imtcp" address="127.0.0.1" port="524") - -# No matter your Rsyslog version, you should set this option to off -# if you plan to use Fail2ban -$RepeatedMsgReduction off -``` - -Restart rsyslog after enabling the TCP listener. - -Now setup Docker daemon to start with the syslog driver. -This enables the syslog driver for all containers! - -Linux users can add or change the configuration in `/etc/docker/daemon.json`. Windows users please have a look at the [docker documentation](https://docs.docker.com/engine/reference/commandline/dockerd//#windows-configuration-file) : -``` -{ -... - "log-driver": "syslog", - "log-opts": { - "syslog-address": "tcp://127.0.0.1:524" - } -... -} - -``` - -!!! info - If you prefere the udp protocol use: - - ``` - $ModLoad imudp - $UDPServerRun 524 - ``` - - at `rsyslog.conf` and `"syslog-address": "udp://127.0.0.1:524"` at `daemon.json`. - -Restart the Docker daemon and run `docker-compose down && docker-compose up -d` to recreate the containers. - - -### Fail2ban - -**This is a subsection of "Log to Syslog", which is required for Fail2ban to work.** - -Open `/etc/fail2ban/filter.d/common.conf` and search for the prefix_line parameter, change it to ".*": - -``` -__prefix_line = .* -``` - -Create `/etc/fail2ban/jail.d/dovecot.conf`... -``` -[dovecot] -enabled = true -filter = dovecot -logpath = /var/log/syslog -chain = FORWARD -``` - -and `jail.d/postfix-sasl.conf`: -``` -[postfix-sasl] -enabled = true -filter = postfix-sasl -logpath = /var/log/syslog -chain = FORWARD -``` - -Restart Fail2ban. diff --git a/docs/prerequesite-dns.md b/docs/prerequesite-dns.md index 15a6b376e..94cbcfeff 100644 --- a/docs/prerequesite-dns.md +++ b/docs/prerequesite-dns.md @@ -57,7 +57,6 @@ _pop3._tcp IN SRV 0 1 110 mail.example.org. _pop3s._tcp IN SRV 0 1 995 mail.example.org. _submission._tcp IN SRV 0 1 587 mail.example.org. _smtps._tcp IN SRV 0 1 465 mail.example.org. -_autoconfig._tcp IN SRV 0 1 443 autoconfig.example.org. _autodiscover._tcp IN SRV 0 1 443 autodiscover.example.org. ``` diff --git a/docs/u_e-autodiscover_config.md b/docs/u_e-autodiscover_config.md index a832b74a8..e2ec2beab 100644 --- a/docs/u_e-autodiscover_config.md +++ b/docs/u_e-autodiscover_config.md @@ -1,5 +1,9 @@ This disables ActiveSync in the autodiscover service for Outlook and configures it with IMAP and SMTP instead: -Open `data/web/autodiscover.php` and set `'useEASforOutlook' => 'yes'` to `'useEASforOutlook' => 'no'`. +Open or create `data/web/inc/vars.local.inc.php` and paste the following code-block at the last line: +> Note: make sure that the file starts with ` 'imap'`. +Tell Outlook clients to use SMTP and IMAP `'useEASforOutlook' => 'yes'` to `'useEASforOutlook' => 'no'`. \ No newline at end of file diff --git a/docs/u_e-mailcow_ui-config.md b/docs/u_e-mailcow_ui-config.md index 5b19433ab..1101c1540 100644 --- a/docs/u_e-mailcow_ui-config.md +++ b/docs/u_e-mailcow_ui-config.md @@ -1,4 +1,5 @@ Several configuration parameters of the mailcow UI can be changed by creating a file `data/web/inc/vars.local.inc.php` which overrides defaults settings found in `data/web/inc/vars.inc.php`. +For example, these are used by `data/web/autodiscover.php`. The local configuration file is persistent over updates of mailcow. Try not to change values inside `data/web/inc/vars.inc.php`, but use them as template for the local override. diff --git a/docs/u_e-why_bind9.md b/docs/u_e-why_dns_recursor.md similarity index 100% rename from docs/u_e-why_bind9.md rename to docs/u_e-why_dns_recursor.md diff --git a/mkdocs.yml b/mkdocs.yml index c7ecbc139..17621ffdf 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -30,7 +30,6 @@ pages: - 'Rspamd Web UI': 'firststeps-rspamd_ui.md' - 'Reverse Proxy': 'firststeps-rp.md' - 'Setup a relayhost': 'firststeps-relayhost.md' - - 'Log to Syslog': 'firststeps-syslog.md' - 'Local MTA on Docker host': 'firststeps-local_mta.md' - 'Sender and receiver model': 'firststeps-sender_rcv.md' - 'Debugging & Troubleshooting': @@ -59,7 +58,7 @@ pages: - 'Docker': - 'Customize Dockerfiles': 'u_e-docker-cust_dockerfiles.md' - 'Docker Compose Bash Completion': 'u_e-docker-dc_bash_compl.md' - - 'Why bind9?': 'u_e-why_bind9.md' + - 'Why a DNS recursor?': 'u_e-why_dns_recursor.md' - 'Backup & Restore': - 'Backup Maildir': 'u_e-backup_restore-maildir.md' - 'MySQL': 'u_e-backup_restore-mysql.md'