Added new Tags Page, Netfilter Page improved update page
BIN
docs/assets/images/manual-guides/mailcow-domain_email_tags.de.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 65 KiB |
BIN
docs/assets/images/manual-guides/mailcow-domain_email_tags.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 57 KiB |
BIN
docs/assets/images/manual-guides/mailcow-domain_tags_ribbon.de.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 27 KiB |
BIN
docs/assets/images/manual-guides/mailcow-domain_tags_ribbon.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 24 KiB |
BIN
docs/assets/images/manual-guides/mailcow-netfilter_regex.de.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 72 KiB |
BIN
docs/assets/images/manual-guides/mailcow-netfilter_regex.en.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 72 KiB |
BIN
docs/assets/images/manual-guides/mailcow-netfilter_settings.de.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 55 KiB |
BIN
docs/assets/images/manual-guides/mailcow-netfilter_settings.en.png
Normale Datei
Nachher Breite: | Höhe: | GröĂe: 51 KiB |
|
@ -27,6 +27,9 @@ Einige kleinere Konflikte werden automatisch korrigiert (zugunsten des mailcow:
|
||||||
# - Starten Sie mailcow nicht, nachdem Sie ein Update durchgefĂŒhrt haben
|
# - Starten Sie mailcow nicht, nachdem Sie ein Update durchgefĂŒhrt haben
|
||||||
./update.sh --skip-start
|
./update.sh --skip-start
|
||||||
|
|
||||||
|
# - Ăberspringt den ICMP Check auf die öffentlichen DNS Resolver (Bitte nur nutzen, wenn keinerlei ICMP Verbindungen von und zur mailcow erlaubt sind)
|
||||||
|
./update.sh --skip-ping-check
|
||||||
|
|
||||||
# - Erzwinge Update (unbeaufsichtigt, aber nicht unterstĂŒtzt, Benutzung auf eigenes Risiko)
|
# - Erzwinge Update (unbeaufsichtigt, aber nicht unterstĂŒtzt, Benutzung auf eigenes Risiko)
|
||||||
./update.sh --force
|
./update.sh --force
|
||||||
|
|
||||||
|
@ -70,6 +73,8 @@ docker-compose up -d
|
||||||
|
|
||||||
Sie können sich in den Update-Mechanismus einklinken, indem Sie Skripte namens `pre_commit_hook.sh` und `post_commit_hook.sh` zu Ihrem mailcows-Root-Verzeichnis hinzufĂŒgen. Siehe [hier](../manual-guides/u_e-update-hooks.md) fĂŒr weitere Details.
|
Sie können sich in den Update-Mechanismus einklinken, indem Sie Skripte namens `pre_commit_hook.sh` und `post_commit_hook.sh` zu Ihrem mailcows-Root-Verzeichnis hinzufĂŒgen. Siehe [hier](../manual-guides/u_e-update-hooks.md) fĂŒr weitere Details.
|
||||||
|
|
||||||
## FuĂnoten
|
## Update-Zyklus
|
||||||
|
|
||||||
- Wir planen einen monatlichen Release-Zyklus fĂŒr Updates ein.
|
- Wir planen an jedem ersten Dienstag eines Monats ein neues Hauptupdate zu veröffentlichen.
|
||||||
|
- Die Updates sind wie folgt nummeriert: `JJJJ-MM` (Beispiel: `2022-05`).
|
||||||
|
- Fehlerkorrekturen eines Hauptupdates werden bei uns als "Revisionen" wie a,b,c (Beispiele: `2022-05a`, `2022-05b` usw.) erscheinen.
|
||||||
|
|
|
@ -27,6 +27,9 @@ Some minor conflicts will be auto-corrected (in favour for the mailcow: dockeriz
|
||||||
# - Do not start mailcow after applying an update
|
# - Do not start mailcow after applying an update
|
||||||
./update.sh --skip-start
|
./update.sh --skip-start
|
||||||
|
|
||||||
|
# - Skip ICMP Check to public DNS resolvers (Use it only if youÂŽve blocked any ICMP Connections to your mailcow machine)
|
||||||
|
./update.sh --skip-ping-check
|
||||||
|
|
||||||
# - Force update (unattended, but unsupported, use at own risk)
|
# - Force update (unattended, but unsupported, use at own risk)
|
||||||
./update.sh --force
|
./update.sh --force
|
||||||
|
|
||||||
|
@ -70,6 +73,8 @@ docker-compose up -d
|
||||||
|
|
||||||
You can hook into the update mechanism by adding scripts called `pre_commit_hook.sh` and `post_commit_hook.sh` to your mailcows root directory. See [this](../manual-guides/u_e-update-hooks.md) for more details.
|
You can hook into the update mechanism by adding scripts called `pre_commit_hook.sh` and `post_commit_hook.sh` to your mailcows root directory. See [this](../manual-guides/u_e-update-hooks.md) for more details.
|
||||||
|
|
||||||
## Footnotes
|
## Update Cycle
|
||||||
|
|
||||||
- We schedule a monthly release cycle for updates.
|
- We schedule a monthly release cycle for a major update at the first tuesday of the month.
|
||||||
|
- The releases are numbered like this: `YYYY-MM` (e.g. `2022-05`)
|
||||||
|
- Fixes for a main Update will be stated as "Revisions" like a,b,c (e.g. `2022-05a`, `2022-05b` etc.)
|
29
docs/manual-guides/mailcow-UI/u_e-mailcow_ui-netfilter.de.md
Normale Datei
|
@ -0,0 +1,29 @@
|
||||||
|
## Netfilter Ban-Einstellungen Àndern
|
||||||
|
|
||||||
|
Um die Netfilter Ban-Einstellungen zu Ă€ndern navigieren Sie zu dem MenĂŒ Punkt: `Konfiguration -> Server-Konfiguration -> Konfiguration -> Fail2ban-Parameter`.
|
||||||
|
|
||||||
|
Sie sollten dann dieses Fenster sehen:
|
||||||
|
|
||||||
|
![Netfilter ban settings](../../assets/images/manual-guides/mailcow-netfilter_settings.de.png)
|
||||||
|
|
||||||
|
Hier können Sie verschiedene Optionen fĂŒr die Banns selbst festlegen.
|
||||||
|
Zum Beispiel die max. Ban-Zeit oder die max. Versuche bevor ein Ban ausgefĂŒhrt wird.
|
||||||
|
|
||||||
|
|
||||||
|
## Netfilter Regex Àndern
|
||||||
|
|
||||||
|
!!! danger "Achtung"
|
||||||
|
Folgender Bereich erfordert zumindest grundlegende Regex kenntnisse. <br>
|
||||||
|
Sollten Sie sich nicht sicher sein, was Sie dort tun, können wir Ihnen nur von der Umkonfiguration abraten.
|
||||||
|
|
||||||
|
Sie können neben den Sperreinstellungen ebenfalls definieren, was genau aus den Logs der mailcow Container verwendet werden soll um einen möglichen Angreifer zu sperren.
|
||||||
|
|
||||||
|
DafĂŒr mĂŒssen Sie das Regex Feld erst einmal aufklappen, was dann in etwa so aussieht:
|
||||||
|
|
||||||
|
![Netfilter Regex](../../assets/images/manual-guides/mailcow-netfilter_regex.de.png)
|
||||||
|
|
||||||
|
Dort können Sie nun verschiedenste neue Filter-Regeln anlegen.
|
||||||
|
|
||||||
|
!!! info "Hinweis"
|
||||||
|
Mit weiterschreitenden Updates ist es möglich, dass neue Netfilter Regex Regeln dazu kommen oder entfernt werden. <br>
|
||||||
|
Sollte das der Fall sein empfiehlt es sich mit einem Klick auf `ZurĂŒcksetzen auf Standard` die Netfilter Regex Regeln neu laden zu lassen.
|
28
docs/manual-guides/mailcow-UI/u_e-mailcow_ui-netfilter.en.md
Normale Datei
|
@ -0,0 +1,28 @@
|
||||||
|
## Change Netfilter Ban Settings
|
||||||
|
|
||||||
|
To change the Netfilter settings in general please navigate to: `Configuration -> Configuration & Details -> Configuration -> Fail2ban parameters`.
|
||||||
|
|
||||||
|
You should now see a familar interface:
|
||||||
|
|
||||||
|
![Netfilter ban settings](../../assets/images/manual-guides/mailcow-netfilter_settings.en.png)
|
||||||
|
|
||||||
|
Here you can set several options regarding the bans itself.
|
||||||
|
For example the max. Ban time or the max. attempts before a ban is executed.
|
||||||
|
|
||||||
|
## Change Netfilter Regex
|
||||||
|
|
||||||
|
!!! danger
|
||||||
|
The following area requires at least basic regex knowledge. <br>
|
||||||
|
If you are not sure what you are doing there, we can only advise you not to attempt a reconfiguration.
|
||||||
|
|
||||||
|
In addition to the ban settings, you can also define what exactly should be used from the mailcow container logs to ban a possible attacker.
|
||||||
|
|
||||||
|
To do this, you must first expand the regex field, which will look something like this:
|
||||||
|
|
||||||
|
![Netfilter Regex](../../assets/images/manual-guides/mailcow-netfilter_regex.en.png)
|
||||||
|
|
||||||
|
There you can now create various new filter rules.
|
||||||
|
|
||||||
|
!!! info
|
||||||
|
As updates progress, it is possible that new Netfilter regex rules will be added or removed. <br>
|
||||||
|
If this is the case, it is recommended to reset the Netfilter regex rules by clicking on `Reset to default`.
|
|
@ -1,7 +1,7 @@
|
||||||
Mailbox-Nutzer können ihre Mailadresse wie in "me+facebook@example.org" markieren. Sie können die Tag-Behandlung im **mailcow UI** Panel (fĂŒr den Benutzer) unter `Mailbox > Einstellungen` kontrollieren.
|
Mailbox-Nutzer können ihre Mailadresse wie in "me+facebook@example.org" markieren. Sie können die Tag-Behandlung im **mailcow UI** Panel (fĂŒr den Benutzer) unter `Mailbox > Einstellungen` kontrollieren.
|
||||||
![mailcow mail tagging settings](../../assets/images/manual-guides/mailcow-tagging.png)
|
![mailcow mail tagging settings](../../assets/images/manual-guides/mailcow-tagging.png)
|
||||||
|
|
||||||
*Tagging ist auch bekannt als 'Sub-Adressierung' (RFC 5233) oder 'Plus-Adressierung'*
|
*`Sub-Adressierung` (RFC 5233) oder `Plus-Adressierung` auch als Tagging bekannt (nicht zu verwechseln mit [Tags](../u_e-mailcow_ui-tags.md))*
|
||||||
|
|
||||||
|
|
||||||
### VerfĂŒgbare Aktionen
|
### VerfĂŒgbare Aktionen
|
|
@ -1,7 +1,7 @@
|
||||||
Mailbox users can tag their mail address like in `me+facebook@example.org`. They can control the tag handling in the users **mailcow UI** panel under `Mailbox > Settings`.
|
Mailbox users can tag their mail address like in `me+facebook@example.org`. They can control the tag handling in the users **mailcow UI** panel under `Mailbox > Settings`.
|
||||||
![mailcow mail tagging settings](../../assets/images/manual-guides/mailcow-tagging.png)
|
![mailcow mail tagging settings](../../assets/images/manual-guides/mailcow-tagging.png)
|
||||||
|
|
||||||
*Tagging is also known as 'sub-addressing' (RFC 5233) or 'plus addressing'*
|
*`sub-addressing` (RFC 5233) or `plus addressing` also known as tagging (do not mix with [Tags](../u_e-mailcow_ui-tags.md))*
|
||||||
|
|
||||||
|
|
||||||
### Available Actions
|
### Available Actions
|
25
docs/manual-guides/mailcow-UI/u_e-mailcow_ui-tags.de.md
Normale Datei
|
@ -0,0 +1,25 @@
|
||||||
|
!!! info "Hinweis"
|
||||||
|
Um diese Funktion nutzen zu können ist das Update 2022-05 (oder höher) erforderlich!<br>
|
||||||
|
Sollten Sie das Update nicht installiert haben, denken Sie bitte ĂŒber ein Update nach.<br>
|
||||||
|
FĂŒr weitere Informationen bezĂŒglich dem Update Prozess schauen Sie [hier](../../i_u_m/i_u_m_update.md).
|
||||||
|
|
||||||
|
### WofĂŒr wurden die Tags implementiert?
|
||||||
|
Mit den Tags ist es deutlich einfacher gezielt nach Domains bzw. Mailboxen zu suchen (wenn diese einen Tag haben).
|
||||||
|
|
||||||
|
### Wo lassen sich die Tags finden?
|
||||||
|
Die Tags befinden sich in der Domain/Mailbox Sektion der mailcow UI.
|
||||||
|
Um sie zu sehen, klicken Sie einfach auf das kleine Plus-Symbol auf der linken Seite Ihrer Domain/Mailbox (das folgende Bild zeigt das Domain-Ribbon-MenĂŒ):
|
||||||
|
![Domain/Mailbox Tags Ribbon](../../assets/images/manual-guides/mailcow-domain_tags_ribbon.de.png)
|
||||||
|
|
||||||
|
### Wie kann ich ein Tag hinzufĂŒgen/entfernen?
|
||||||
|
Sie können bei der Erstellung einer neuen Domain/eines neuen Postfachs einfach ein Tag hinzufĂŒgen/entfernen. Sie können sie auch hinzufĂŒgen/entfernen, wenn Sie Ihre gewĂŒnschte Domain/Mailbox bearbeiten.
|
||||||
|
|
||||||
|
Es sieht Àhnlich aus wie hier (das folgende Bild zeigt den Bereich zur Bearbeitung der DomÀne):
|
||||||
|
|
||||||
|
![Domain/Mailbox Tags](../../assets/images/manual-guides/mailcow-domain_email_tags.de.png)
|
||||||
|
|
||||||
|
|
||||||
|
### Wie kann ich nach einem Tag suchen?
|
||||||
|
Geben Sie einfach den Tag-Namen in die Suchleiste im Bereich Domain/Postfach ein und warten Sie, bis der Vorgang abgeschlossen ist.
|
||||||
|
|
||||||
|
Sie können sogar angeben, ob Sie nur nach Tags suchen möchten.
|
26
docs/manual-guides/mailcow-UI/u_e-mailcow_ui-tags.en.md
Normale Datei
|
@ -0,0 +1,26 @@
|
||||||
|
!!! info
|
||||||
|
You need the mailcow Version 2022-05 at least for this feature.<br>
|
||||||
|
If you donÂŽt have the Version installed please consider a update.<br>
|
||||||
|
For more informations about a mailcow update please take a look at the [Update](../../i_u_m/i_u_m_update.md) section here in the docs.
|
||||||
|
|
||||||
|
### What are Tags designed for?
|
||||||
|
With the Tags you can easily sort your Domains and Mailboxes by the tags instead of their name.
|
||||||
|
|
||||||
|
### Where are the Tags located?
|
||||||
|
The Tags are located in the Domain/Mailbox section of the mailcow UI.
|
||||||
|
To view them simply click on the small plus symbol on the left of your Domain/Mailbox (following picture is showing the domain ribbon menu):
|
||||||
|
![Domain/Mailbox Tags Ribbon](../../assets/images/manual-guides/mailcow-domain_tags_ribbon.png)
|
||||||
|
|
||||||
|
|
||||||
|
### How can i add/remove a Tag?
|
||||||
|
You can simply add/remove a Tag during the creation of a new Domain/Mailbox. You also can add/remove them if you edit your desired Domain/Mailbox.
|
||||||
|
|
||||||
|
It looks similar to this (following picture showing the domain edit section):
|
||||||
|
|
||||||
|
![Domain/Mailbox Tags](../../assets/images/manual-guides/mailcow-domain_email_tags.png)
|
||||||
|
|
||||||
|
|
||||||
|
### How can i search for a tag?
|
||||||
|
Simply type the Tag Name in the search bar in the Domain/Mailbox Section and wait for it to complete.
|
||||||
|
|
||||||
|
You can even specify if you want to search for tags only.
|
11
mkdocs.yml
|
@ -91,9 +91,11 @@ nav:
|
||||||
- 'Blacklist / Whitelist': 'manual-guides/mailcow-UI/u_e-mailcow_ui-bl_wl.md'
|
- 'Blacklist / Whitelist': 'manual-guides/mailcow-UI/u_e-mailcow_ui-bl_wl.md'
|
||||||
- 'Configuration': 'manual-guides/mailcow-UI/u_e-mailcow_ui-config.md'
|
- 'Configuration': 'manual-guides/mailcow-UI/u_e-mailcow_ui-config.md'
|
||||||
- 'CSS overrides': 'manual-guides/mailcow-UI/u_e-mailcow_ui-css.md'
|
- 'CSS overrides': 'manual-guides/mailcow-UI/u_e-mailcow_ui-css.md'
|
||||||
|
- 'Netfilter': 'manual-guides/mailcow-UI/u_e-mailcow_ui-netfilter.md'
|
||||||
- 'Pushover': 'manual-guides/mailcow-UI/u_e-mailcow_ui-pushover.md'
|
- 'Pushover': 'manual-guides/mailcow-UI/u_e-mailcow_ui-pushover.md'
|
||||||
- 'Spamfilter': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamfilter.md'
|
- 'Spamfilter': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamfilter.md'
|
||||||
- 'Tagging': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tagging.md'
|
- 'Sub-addressing': 'manual-guides/mailcow-UI/u_e-mailcow_ui-sub_addressing.md'
|
||||||
|
- 'Tags (for Domains and Mailboxes)': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tags.md'
|
||||||
- 'Temporary email aliases': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamalias.md'
|
- 'Temporary email aliases': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamalias.md'
|
||||||
- 'Two-Factor Authentication': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tfa.md'
|
- 'Two-Factor Authentication': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tfa.md'
|
||||||
- 'WebAuthn / FIDO2': 'manual-guides/mailcow-UI/u_e-mailcow_ui-fido.md'
|
- 'WebAuthn / FIDO2': 'manual-guides/mailcow-UI/u_e-mailcow_ui-fido.md'
|
||||||
|
@ -214,8 +216,9 @@ plugins:
|
||||||
### Mailcow UI Subsection
|
### Mailcow UI Subsection
|
||||||
'Configuration' : 'Konfiguration'
|
'Configuration' : 'Konfiguration'
|
||||||
'CSS overrides' : 'CSS-Ăberschreibungen'
|
'CSS overrides' : 'CSS-Ăberschreibungen'
|
||||||
'Tagging' : 'Tagging (Markierungen)'
|
'Sub-addressing' : 'Sub-Adressierung'
|
||||||
'Temporary email aliases' : 'TemporÀre E-Mail-Aliase'
|
'Temporary email aliases' : 'TemporÀre E-Mail-Aliase'
|
||||||
|
'Tags (for Domains and Mailboxes)' : 'Tags (fĂŒr Domains und Mailboxen)'
|
||||||
'Two-Factor Authentication' : 'Zwei-Faktoren-Authentifizierung'
|
'Two-Factor Authentication' : 'Zwei-Faktoren-Authentifizierung'
|
||||||
### Postfix Subsection
|
### Postfix Subsection
|
||||||
'Add trusted networks': 'VertrauenswĂŒrdige Netzwerke hinzufĂŒgen'
|
'Add trusted networks': 'VertrauenswĂŒrdige Netzwerke hinzufĂŒgen'
|
||||||
|
@ -309,10 +312,12 @@ plugins:
|
||||||
'u_e-mailcow_ui-bl_wl.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-bl_wl.en.md'
|
'u_e-mailcow_ui-bl_wl.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-bl_wl.en.md'
|
||||||
'u_e-mailcow_ui-config.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-config.en.md'
|
'u_e-mailcow_ui-config.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-config.en.md'
|
||||||
'u_e-mailcow_ui-css.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-css.en.md'
|
'u_e-mailcow_ui-css.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-css.en.md'
|
||||||
|
'u_e-mailcow_ui-netfilter.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-netfilter.en.md'
|
||||||
'u_e-mailcow_ui-pushover.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-pushover.en.md'
|
'u_e-mailcow_ui-pushover.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-pushover.en.md'
|
||||||
'u_e-mailcow_ui-spamfilter.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamfilter.en.md'
|
'u_e-mailcow_ui-spamfilter.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamfilter.en.md'
|
||||||
'u_e-mailcow_ui-tagging.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tagging.en.md'
|
'u_e-mailcow_ui-sub_addressing.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-sub_addressing.en.md'
|
||||||
'u_e-mailcow_ui-spamalias.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamalias.en.md'
|
'u_e-mailcow_ui-spamalias.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-spamalias.en.md'
|
||||||
|
'u_e-mailcow_ui-tags.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tags.en.md'
|
||||||
'u_e-mailcow_ui-tfa.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tfa.en.md'
|
'u_e-mailcow_ui-tfa.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-tfa.en.md'
|
||||||
'u_e-mailcow_ui-fido.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-fido.en.md'
|
'u_e-mailcow_ui-fido.md': 'manual-guides/mailcow-UI/u_e-mailcow_ui-fido.en.md'
|
||||||
'u_e-postfix-trust_networks.md': 'manual-guides/Postfix/u_e-postfix-trust_networks.en.md'
|
'u_e-postfix-trust_networks.md': 'manual-guides/Postfix/u_e-postfix-trust_networks.en.md'
|
||||||
|
|