Merge branch 'broedli-master'

docs/debug-common_problems.md

@@ -22,7 +22,7 @@ Escape character is '^]'.
 
 ## My mails are identified as Spam
 
-Please read our guide on [DNS configuration](dns.md).
+Please read our guide on [DNS configuration](prerequesite-dns.md).
 
 ## docker-compose throws weird erros
 
@@ -51,4 +51,4 @@ If you get an error message like:
 ERROR: for postfix-mailcow  Cannot start service postfix-mailcow: driver failed programming external     connectivity on endpoint mailcowdockerized_postfix-mailcow_1: Error starting userland proxy: listen tcp 0.0.0.0:25: bind: address already in use
 ```
 
-while trying to start / install mailcow: dockerized, make sure you've followed our section on the [prerequisites](requirements/#firewall-ports).
+while trying to start / install mailcow: dockerized, make sure you've followed our section on the [prerequisites](prerequesite-system/#firewall-ports).

docs/debug-reset_pw.md

@@ -7,12 +7,6 @@ cd mailcow_path
 bash mailcow-reset-admin.sh
 ```
 
-## Remove Two-Factor Authentication
-
-```
-
-```
-
 ## Reset MySQL Passwords
 
 Stop the stack by running `docker-compose stop`.
@@ -26,6 +20,8 @@ docker-compose run --rm --entrypoint '/bin/sh -c "gosu mysql mysqld --skip-grant
 ### 1\. Find database name
 
 ```
+# source mailcow.conf
+# docker-compose exec mysql-mailcow mysql -u${DBUSER} -p${DBPASS} ${DBNAME}
 MariaDB [(none)]> show databases;
 +--------------------+
 | Database           |
@@ -57,3 +53,12 @@ MariaDB [(none)]> UPDATE mysql.user SET authentication_string = PASSWORD('gotr00
 MariaDB [(none)]> UPDATE mysql.user SET authentication_string = PASSWORD('mookuh'), password = PASSWORD('mookuh') WHERE User = 'mailcow' AND Host = '%';
 MariaDB [(none)]> FLUSH PRIVILEGES;
 ```
+
+## Remove Two-Factor Authentication
+
+This works similar to resetting a MySQL password, now we do it from the host without connecting to the MySQL cli:
+
+```
+source mailcow.conf
+docker-compose exec mysql-mailcow mysql -u${DBUSER} -p${DBPASS} ${DBNAME} -e DELETE FROM tfa WHERE username='YOUR_USERNAME'
+```

docs/migrate-mc014.md

@@ -4,7 +4,7 @@
 !!! info
     Also note that this guide doesn't touch on the users settings like *Spamlevels*, *TLS Settings*, etc. nor the export / import of your roundcube or SOGo settings.
 
-    Lastly please check the section on how to [import / restore](backup_maildir/#restore) your maildir backup to get an idea how to migrate your mails.
+    Lastly please check the section on how to [import / restore](u_e-backup_restore-maildir/#restore) your maildir backup to get an idea how to migrate your mails.
 
 ## Create mailcow db backups
 

docs/prerequesite-system.md

@@ -5,7 +5,7 @@ Before you run **mailcow: dockerized**, there are a few requirements that you sh
 
 !!! info
     - Mailcow: dockerized requires [some ports](#default-ports) to be open for incomming connections, so make sure that your firewall is not bloking these. Also make sure that no other application is interferring with mailcow's configuration.
-    - A correct DNS setup is crucial to every good mailserver setup, so please make sure you got at least the [basics](dns/#the-minimal-dns-configuration) covered bevore you begin!
+    - A correct DNS setup is crucial to every good mailserver setup, so please make sure you got at least the [basics](prerequesite-dns/#the-minimal-dns-configuration) covered bevore you begin!
     - Make sure that your system has a correct date and [time setup](#date-and-time). This is crucial for stuff like two factor TOTP authentication.
 
 ## Minimum System Resources

docs/u_e-mailcow_ui-bl_wl.md

@@ -4,4 +4,4 @@ To add or edit an entry to your **domain wide** filter table, login to your *mai
 
 
 !!! info
-    Be aware that a user [may override](spamfilter.md) this setting by setting his own black- and whitelist!
+    Be aware that a user [may override](u_e-mailcow_ui-spamalias.md) this setting by setting his own black- and whitelist!

docs/u_e-mailcow_ui-spamfilter.md

@@ -3,6 +3,6 @@ A mailbox user may adjust the spam filter and black- / whitelist settings for hi
 ![Where to adjust the users spam, black- and whitelist settings](images/mailcow-spamfilter.png)
 
 !!! info
-    For global adjustments on your spam filter please check our section on [Rspamd](rspamd.md).
+    For global adjustments on your spam filter please check our section on [Rspamd](u_e-rspamd.md).
 
-    For a domain wide black- and whitelist please check our guide on [Black / Whitelist](bl_wl.md)
+    For a domain wide black- and whitelist please check our guide on [Black / Whitelist](u_e-mailcow_ui-bl_wl.md)

docs/u_e-redis.md

@@ -30,7 +30,7 @@ OK
 Get all keys matching your pattern:
 
 ```
-
+KEYS *
 ```
 
 ##### PING

mkdocs.yml

@@ -14,54 +14,55 @@ markdown_extensions:
 pages:
 - 'Information & Support': 'index.md'
 - 'Prerequisites':
-  - 'Prepare Your System': 'requirements.md'
+  - 'Prepare Your System': 'prerequesite-system.md'
-  - 'DNS Setup': 'dns.md'
+  - 'DNS Setup': 'prerequesite-dns.md'
-- 'Migrating from mailcow 0.14': 'mc14_migrate.md'
+- 'Migrating from mailcow 0.14': 'migrate-mc014.md'
 - 'Installation & Update':
   - 'Installation': 'install.md'
-  - 'Update': 'update.md'
+  - 'Update': 'install-update.md'
 - 'First Steps (optional)':
-  - 'SSL': 'ssl.md'
+  - 'SSL': 'firststeps-ssl.md'
-  - 'Rspamd Web UI': 'rspamd_ui.md'
+  - 'Rspamd Web UI': 'firststeps-rspamd_ui.md'
-  - 'Reverse Proxy': 'rp.md'
+  - 'Reverse Proxy': 'firststeps-rp.md'
-  - 'Setup a relayhost': 'relayhost.md'
+  - 'Setup a relayhost': 'firststeps-relayhost.md'
-  - 'Log to Syslog': 'syslog.md'
+  - 'Log to Syslog': 'firststeps-syslog.md'
-  - 'Local MTA on Docker host': 'local_mta.md'
+  - 'Local MTA on Docker host': 'firststeps-local_mta.md'
-  - 'Sender and receiver model': 'sender_rcv.md'
+  - 'Sender and receiver model': 'firststeps-sender_rcv.md'
 - 'Debugging & Troubleshooting':
     - 'Introduction': debug.md
-    - 'Logs': 'debug_logs.md'
+    - 'Logs': 'debug-logs.md'
-    - 'Attach a Container': 'attach_service.md'
+    - 'Attach a Container': 'debug-attach_service.md'
-    - 'Reset Passwords': 'reset_pw.md'
+    - 'Reset Passwords': 'debug-reset_pw.md'
-    - 'Remove Persistent Data': 'rm_volumes.md'
+    - 'Remove Persistent Data': 'debug-rm_volumes.md'
-    - 'Common Problems': 'troubles.md'
+    - 'Common Problems': 'debug-common_problems.md'
 - 'Usage & Examples':
   - 'mailcow UI':
-      - 'Configuration': 'mailcow_ui.md'
+      - 'Configuration': 'u_e-mailcow_ui-config.md'
-      - 'Blacklist / Whitelist': 'bl_wl.md'
+      - 'Blacklist / Whitelist': 'u_e-mailcow_ui-bl_wl.md'
-      - 'Spamfilter': 'spamfilter.md'
+      - 'Spamfilter': 'u_e-mailcow_ui-spamfilter.md'
-      - 'Temporary email aliase': 'spamalias.md'
+      - 'Temporary email aliase': 'u_e-mailcow_ui-spamalias.md'
-      - 'Tagging': 'tagging.md'
+      - 'Tagging': 'u_e-mailcow_ui-tagging.md'
-      - 'Two-Factor Authentication': 'tfa.md'
+      - 'Two-Factor Authentication': 'u_e-mailcow_ui-tfa.md'
-  - 'Redis': 'redis.md'
+  - 'Redis': 'u_e-redis.md'
-  - 'Rspamd': 'rspamd.md'
+  - 'Rspamd': 'u_e-rspamd.md'
   - 'Postfix':
-      - 'Anonymize Headers': 'anonym_headers.md'
+      - 'Anonymize Headers': 'u_e-postfix-anonym_headers.md'
-      - 'Disable Sender Addresses Verification': 'disable_sender_verification.md'
+      - 'Disable Sender Addresses Verification': 'u_e-postfix-disable_sender_verification.md'
-  - 'Why bind9?': 'why_bind9.md'
+  - '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'
   - 'Backup & Restore':
-      - 'Backup Maildir': 'backup_maildir.md'
+      - 'Backup Maildir': 'u_e-backup_restore-maildir.md'
-      - 'MySQL': 'mysql.md'
+      - 'MySQL': 'u_e-backup_restore-mysql.md'
-  - 'Autodiscover / Autoconfig': 'autodiscover_config.md'
+  - 'Autodiscover / Autoconfig': 'u_e-autodiscover_config.md'
-  - 'Redirect HTTP to HTTPS': '80_to_443.md'
+  - 'Redirect HTTP to HTTPS': 'u_e-80_to_443.md'
-  - 'Adjust Service Configurations': 'change_config.md'
+  - 'Adjust Service Configurations': 'u_e-change_config.md'
-  - 'Customize Dockerfiles': 'cust_dockerfiles.md'
+  - 'Deinstall': 'u_e-deinstall.md'
-  - 'Docker Compose Bash Completion': 'dc_bash_compl.md'
-  - 'Deinstall': 'deinstall.md'
 - 'Third party apps':
-  - 'Roundcube': 'roundcube.md'
+  - 'Roundcube': 'third_party-roundcube.md'
-  - 'Portainer': 'portainer.md'
+  - 'Portainer': 'third_party-portainer.md'
-  - 'Gogs': 'gogs.md'
+  - 'Gogs': 'third_party-gogs.md'
 extra:
   logo: 'images/logo.svg'
   palette: