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
|
||||
./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)
|
||||
./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.
|
||||
|
||||
## 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
|
||||
./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)
|
||||
./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.
|
||||
|
||||
## 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.
|
||||
![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
|
|
@ -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`.
|
||||
![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
|
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'
|
||||
- 'Configuration': 'manual-guides/mailcow-UI/u_e-mailcow_ui-config.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'
|
||||
- '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'
|
||||
- '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'
|
||||
|
@ -214,8 +216,9 @@ plugins:
|
|||
### Mailcow UI Subsection
|
||||
'Configuration' : 'Konfiguration'
|
||||
'CSS overrides' : 'CSS-Ăśberschreibungen'
|
||||
'Tagging' : 'Tagging (Markierungen)'
|
||||
'Sub-addressing' : 'Sub-Adressierung'
|
||||
'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'
|
||||
### Postfix Subsection
|
||||
'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-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-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-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-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-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'
|
||||
|
|