Restructuring + First Changes for ARM64

This commit is contained in:
DerLinkman 2023-12-07 16:45:22 +01:00 committed by DerLinkman
parent 3d6eac8449
commit bcb290e076
No known key found for this signature in database
GPG key ID: D7F5883EFAE75ACA
19 changed files with 84 additions and 70 deletions

View file

@ -1,3 +1,6 @@
!!! success "Überall gleich"
Die Installation ist auf x86 und ARM64 exakt identisch!
## Docker und Docker Compose Installation
Sie benötigen Docker (eine Version >= `20.10.2` ist erforderlich) und Docker Compose (eine Version `>= 2.0` ist erforderlich).

View file

@ -1,3 +1,6 @@
!!! success "It's the same"
The installation is exactly the same on x86 and ARM64 platforms!
## Docker and Docker Compose Installation
You need Docker (a version >= `20.10.2` is required) and Docker Compose (a version `>= 2.0` is required).

View file

@ -6,22 +6,25 @@ Bevor Sie **mailcow: dockerized** ausführen, sollten Sie einige Voraussetzungen
!!! info
- mailcow: dockerized erfordert, dass [einige Ports](#standard-ports) für eingehende Verbindungen offen sind, also stellen Sie sicher, dass Ihre Firewall diese nicht blockiert.
- Stellen Sie sicher, dass keine andere Anwendung die Konfiguration von mailcow stört, wie z.B. ein anderer Maildienst
- Ein korrektes DNS-Setup ist entscheidend für jedes gute Mailserver-Setup, also stellen Sie bitte sicher, dass Sie zumindest die [basics](../prerequisite/prerequisite-dns.de.md#die-minimale-dns-konfiguration) abgedeckt haben, bevor Sie beginnen!
- Ein korrektes DNS-Setup ist entscheidend für jedes gute Mailserver-Setup, also stellen Sie bitte sicher, dass Sie zumindest die [basics](../getstarted/prerequisite-dns.de.md#die-minimale-dns-konfiguration) abgedeckt haben, bevor Sie beginnen!
- Stellen Sie sicher, dass Ihr System ein korrektes Datum und eine korrekte [Zeiteinstellung](#datum-und-uhrzeit) hat. Dies ist entscheidend für verschiedene Komponenten wie die Zwei-Faktor-TOTP-Authentifizierung.
## Minimale Systemressourcen
!!! failure "Nicht unterstützt"
**OpenVZ, Virtuozzo und LXC**
!!! success "Kompatibilität hergestellt"
Seit XXX ist mailcow endlich auch auf ARM64 Plattformen verfügbar! Komplett! Ohne Einschränkungen der Funktionalität!
Bitte stellen Sie sicher, dass Ihr System mindestens über die folgenden Ressourcen verfügt:
| Ressource | mailcow: dockerized |
| Ressource | Minimale Anforderung |
| ----------------------- | ------------------------------------------------ |
| CPU | 1 GHz |
| RAM | **Minimum** 6 GiB + 1 GiB Swap (Standardkonfiguration) |
| Festplatte | 20 GiB (ohne Emails) |
| Systemtyp | x86_64 |
| Architektur | x86_64, ARM64 :warning:{ title="Frisch Released, Fehler können noch existieren"} |
!!! failure "Nicht unterstützt"
**OpenVZ, Virtuozzo und LXC**
ClamAV und Solr können sehr viel Arbeitspeicher verbrauchen. Sie können diese in der `mailcow.conf` durch die Einstellungen `SKIP_CLAMD=y` und `SKIP_SOLR=y` jedoch auch deaktivieren.
@ -199,4 +202,4 @@ Sie können außerdem die [cloud-init Netzwerkänderungen deaktivieren.](https:/
## MTU
Besonders relevant für OpenStack-Benutzer: Überprüfen Sie Ihre MTU und setzen Sie sie entsprechend in docker-compose.yml. Siehe [Problebehandlungen](../i_u_m/i_u_m_install.de.md#benutzer-mit-einer-mtu-ungleich-1500-zb-openstack) in unseren Installationsanleitungen.
Besonders relevant für OpenStack-Benutzer: Überprüfen Sie Ihre MTU und setzen Sie sie entsprechend in docker-compose.yml. Siehe [Problebehandlungen](../getstarted/install.de.md#benutzer-mit-einer-mtu-ungleich-1500-zb-openstack) in unseren Installationsanleitungen.

View file

@ -6,22 +6,25 @@ 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 incoming connections, so make sure that your firewall is not blocking these.
- Make sure that no other application is interfering with mailcow's configuration, such as another mail service
- A correct DNS setup is crucial to every good mailserver setup, so please make sure you got at least the [basics](../prerequisite/prerequisite-dns.en.md#the-minimal-dns-configuration) covered before you begin!
- A correct DNS setup is crucial to every good mailserver setup, so please make sure you got at least the [basics](../getstarted/prerequisite-dns.en.md#the-minimal-dns-configuration) covered before you begin!
- Make sure that your system has a correct date and [time setup](#date-and-time). This is crucial for various components like two factor TOTP authentication.
## Minimum System Resources
!!! failure "Not supported"
**OpenVZ, Virtuozzo and LXC**
!!! success "Compatibility established"
Since XXX mailcow is finally available on ARM64 platforms! Completely! Without any restrictions in functionality!
Please make sure that your system has at least the following resources:
| Resource | mailcow: dockerized |
| Resource | Minimal Requirement |
| ----------------------- | ------------------------------------------------ |
| CPU | 1 GHz |
| RAM | **Minimum** 6 GiB + 1 GiB swap (default config) |
| Disk | 20 GiB (without emails) |
| System Type | x86_64 |
| Architecture | x86_64, ARM64 :warning:{ title="Recently released. Issues may persist."} |
!!! failure "Not supported"
**OpenVZ, Virtuozzo and LXC**
ClamAV and Solr can be greedy with RAM. You may disable them in `mailcow.conf` by settings `SKIP_CLAMD=y` and `SKIP_SOLR=y`.
@ -46,7 +49,7 @@ The following table contains all operating systems officially supported and test
| OS | Compatibility |
| ----------------------- | ------------------------------------------------ |
| Alpine 3.17+ and older | [⚠️](https://www.alpinelinux.org/ "Limited Compatibility") |
| Alpine ab 3.17 | [⚠️](https://www.alpinelinux.org/ "Limited Compatibility") |
| Centos 7 | [](https://www.centos.org/ "Fully Compatible") |
| Debian 10, 11, 12 | [](https://www.debian.org/index.html "Fully Compatible") |
| Ubuntu 18.04, 20.04, 22.04 | [](https://ubuntu.com/ "Fully Compatible")|
@ -197,4 +200,4 @@ You may want to [disable cloud-init network changes.](https://wiki.hetzner.de/in
## MTU
Especially relevant for OpenStack users: Check your MTU and set it accordingly in docker-compose.yml. See [Troubleshooting](../i_u_m/i_u_m_install.md#users-with-a-mtu-not-equal-to-1500-eg-openstack) in our Installation guide.
Especially relevant for OpenStack users: Check your MTU and set it accordingly in docker-compose.yml. See [Troubleshooting](../getstarted/install.md#users-with-a-mtu-not-equal-to-1500-eg-openstack) in our Installation guide.

View file

@ -5,7 +5,7 @@
Alternativ können Sie das Skript `./helper-scripts/backup_and_restore.sh` verwenden, um ein vollständiges Backup auf der Quellmaschine zu erstellen, dann installieren Sie mailcow auf der Zielmaschine wie gewohnt, kopieren Sie Ihre `mailcow.conf` und verwenden Sie das gleiche Skript, um Ihr Backup auf der Zielmaschine wiederherzustellen.
**1\.**
Befolgen Sie die [Installationsanleitung](i_u_m_install.de.md) von Docker und Compose.
Befolgen Sie die [Installationsanleitung](../getstarted/install.de.md) von Docker und Compose.
**2\.** Stoppen Sie Docker und stellen Sie sicher, dass Docker gestoppt wurde:
```

View file

@ -5,7 +5,7 @@
Alternatively, you can use the `./helper-scripts/backup_and_restore.sh` script to create a full backup on the source machine, then install mailcow on the target machine as usual, copy over your `mailcow.conf` and use the same script to restore your backup to the target machine.
**1\.**
Follow the [installation guide](i_u_m_install.en.md) to install Docker and Compose.
Follow the [installation guide](../getstarted/install.en.md) to install Docker and Compose.
**2\.** Stop Docker and assure Docker has stopped:
```

View file

@ -1,7 +1,7 @@
!!! 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).
Für weitere Informationen bezüglich dem Update Prozess schauen Sie [hier](../../maintenance/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).

View file

@ -1,7 +1,7 @@
!!! 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.
For more informations about a mailcow update please take a look at the [Update](../../maintenance/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.

View file

@ -32,7 +32,7 @@ Diese Anleitung basiert auf verschiedenen Schritten:
### DNS-Einrichtung
Der größte Teil der Konfiguration ist in *mailcow*s [DNS Konfiguration](../../prerequisite/prerequisite-dns.de.md) enthalten. Nachdem diese Einrichtung abgeschlossen ist, fügen Sie eine weitere Subdomain für *Mailman* hinzu, z.B. `lists.example.org`, die auf denselben Server zeigt:
Der größte Teil der Konfiguration ist in *mailcow*s [DNS Konfiguration](../../getstarted/prerequisite-dns.de.md) enthalten. Nachdem diese Einrichtung abgeschlossen ist, fügen Sie eine weitere Subdomain für *Mailman* hinzu, z.B. `lists.example.org`, die auf denselben Server zeigt:
```
# Name Typ Wert
@ -90,7 +90,7 @@ certbot certonly -d MAILMAN_DOMAIN
#### Installieren Sie mailcow
Folgen Sie der [mailcow installation](../../i_u_m/i_u_m_install.de.md). **Schritt 5 auslassen und nicht mit starten!**
Folgen Sie der [mailcow installation](../../getstarted/install.de.md). **Schritt 5 auslassen und nicht mit starten!**
#### mailcow konfigurieren
@ -328,7 +328,7 @@ Wenn man eine neue Liste anlegt und versucht, sofort eine E-Mail zu versenden, a
## Update
**mailcow** hat sein eigenes Update-Skript in `/opt/mailcow-dockerized/update.sh`, [siehe die Dokumentation](../../i_u_m/i_u_m_update.de.md).
**mailcow** hat sein eigenes Update-Skript in `/opt/mailcow-dockerized/update.sh`, [siehe die Dokumentation](../../maintenance/update.de.md).
Für **Mailman** holen Sie sich einfach die neueste Version aus dem [github repository](https://github.com/maxking/docker-mailman).

View file

@ -32,7 +32,7 @@ This guide is based on different steps:
### DNS setup
Most of the configuration is covered by *mailcow*s [DNS setup](../../prerequisite/prerequisite-dns.en.md). After finishing this setup add another subdomain for *Mailman*, e.g. `lists.example.org` that points to the same server:
Most of the configuration is covered by *mailcow*s [DNS setup](../../getstarted/prerequisite-dns.en.md). After finishing this setup add another subdomain for *Mailman*, e.g. `lists.example.org` that points to the same server:
```
# Name Type Value
@ -91,7 +91,7 @@ certbot certonly -d MAILMAN_DOMAIN
#### Install mailcow
Follow the [mailcow installation](../../i_u_m/i_u_m_install.en.md). **Omit step 5 and do not pull and start!**
Follow the [mailcow installation](../../getstarted/install.en.md). **Omit step 5 and do not pull and start!**
#### Configure mailcow
@ -329,7 +329,7 @@ When you create a new list and try to immediately send an e-mail, *postfix* resp
## Update
**mailcow** has it's own update script in `/opt/mailcow-dockerized/update.sh`, [see the docs](../../i_u_m/i_u_m_update.en.md).
**mailcow** has it's own update script in `/opt/mailcow-dockerized/update.sh`, [see the docs](../../maintenance/update.en.md).
For **Mailman** just fetch the newest version from the [github repository](https://github.com/maxking/docker-mailman).

View file

@ -21,7 +21,7 @@ Escape-Zeichen ist '^]'.
## Meine Mails werden als Spam identifiziert
Bitte lesen Sie unsere [DNS-Konfiguration](../prerequisite/prerequisite-dns.de.md) Anleitung.
Bitte lesen Sie unsere [DNS-Konfiguration](../getstarted/prerequisite-dns.de.md) Anleitung.
## docker compose wirft seltsame Fehler aus.
@ -50,7 +50,7 @@ Wenn Sie eine Fehlermeldung erhalten wie:
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:25: bind: address already in use
```
während Sie versuchen, mailcow: dockerized zu starten / zu installieren, stellen Sie sicher, dass Sie unseren Abschnitt über [prerequisites](../prerequisite/prerequisite-system.de.md/#firewall-ports) befolgt haben.
während Sie versuchen, mailcow: dockerized zu starten / zu installieren, stellen Sie sicher, dass Sie unseren Abschnitt über [prerequisites](../getstarted/prerequisite-system.de.md/#firewall-ports) befolgt haben.
## XYZ kann keine Verbindung zu ...

View file

@ -22,7 +22,7 @@ Escape character is '^]'.
## My mails are identified as Spam
Please read our guide on [DNS configuration](../prerequisite/prerequisite-dns.en.md).
Please read our guide on [DNS configuration](../getstarted/prerequisite-dns.en.md).
## docker compose throws weird errors
@ -51,7 +51,7 @@ 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](../prerequisite/prerequisite-system.en.md/#firewall-ports).
while trying to start / install mailcow: dockerized, make sure you've followed our section on the [prerequisites](../getstarted/prerequisite-system.en.md/#firewall-ports).
## XYZ can't connect to ...

View file

@ -37,6 +37,7 @@ theme:
- navigation.tracking
- announce.dismiss
- content.tabs.link
- content.tooltips
- search.share
- search.highlight
@ -66,14 +67,24 @@ markdown_extensions:
nav:
- 'Information & Support': 'index.md'
- 'Prerequisites':
- 'Prepare your system': 'prerequisite/prerequisite-system.md'
- 'DNS setup': 'prerequisite/prerequisite-dns.md'
- 'Installation, Update & Migration':
- 'Installation': 'i_u_m/i_u_m_install.md'
- 'Update': 'i_u_m/i_u_m_update.md'
- 'Migration': 'i_u_m/i_u_m_migration.md'
- 'Deinstallation': 'i_u_m/i_u_m_deinstall.md'
- 'Get started':
- 'Prepare your system': 'getstarted/prerequisite-system.md'
- 'DNS setup': 'getstarted/prerequisite-dns.md'
- 'Install mailcow': 'getstarted/install.md'
- 'Maintaining mailcow':
- 'Update': 'maintenance/update.md'
- 'Migration': 'maintenance/migration.md'
- 'Deinstallation': 'maintenance/deinstall.md'
- 'Backup & Restore':
- 'Component backup & restore':
- 'Backup': 'backup_restore/b_n_r-backup.md'
- 'Restore': 'backup_restore/b_n_r-restore.md'
- 'Cold-standby (rolling backup)': 'backup_restore/b_n_r-coldstandby.md'
- 'Manual backups':
- 'Maildir': 'backup_restore/b_n_r-backup_restore-maildir.md'
- 'MySQL (mysqldump)': 'backup_restore/b_n_r-backup_restore-mysql.md'
- 'mailcow-internal backups':
- 'Recover accidentally deleted data': 'backup_restore/b_n_r-accidental_deletion.md'
- 'Post Installation Tasks':
- 'Advanced SSL': 'post_installation/firststeps-ssl.md'
- 'Disable IPv6': 'post_installation/firststeps-disable_ipv6.md'
@ -107,16 +118,6 @@ nav:
- 'Resend Quarantine Notifications': 'troubleshooting/debug-resend-quarantine-notifications.md'
- 'Reset Passwords (incl. SQL)': 'troubleshooting/debug-reset_pw.md'
- 'Reset TLS certificates': 'troubleshooting/debug-reset_tls.md'
- 'Backup & Restore':
- 'Component backup & restore':
- 'Backup': 'backup_restore/b_n_r-backup.md'
- 'Restore': 'backup_restore/b_n_r-restore.md'
- 'Cold-standby (rolling backup)': 'backup_restore/b_n_r-coldstandby.md'
- 'Manual backups':
- 'Maildir': 'backup_restore/b_n_r-backup_restore-maildir.md'
- 'MySQL (mysqldump)': 'backup_restore/b_n_r-backup_restore-mysql.md'
- 'mailcow-internal backups':
- 'Recover accidentally deleted data': 'backup_restore/b_n_r-accidental_deletion.md'
- 'Manual/Guides/Examples':
- 'mailcow UI':
- 'Blacklist / Whitelist': 'manual-guides/mailcow-UI/u_e-mailcow_ui-bl_wl.md'
@ -219,12 +220,23 @@ plugins:
nav_translations:
#### Begin of german translation
'Information & Support': 'Informationen & Support'
### Prerequisites Section
'Prerequisites': 'Voraussetzungen'
### Getstarted Section
'Get started': 'Loslegen'
'Prepare your system': 'Systemvoraussetzungen'
'DNS setup': 'DNS Einstellungen'
### Installation Section
'Installation, Update & Migration': 'Installation, Update und Migration'
'Install mailcow': 'mailcow Installieren'
### Maintaining Section
'Maintaining mailcow': 'mailcow warten (Updates usw.)'
### Backup & Restore Section
'Backup & Restore': 'Sichern & Wiederherstellen'
'Component backup & restore' : 'Sicherung und Wiederherstellung von Komponenten'
'Backup': 'Sicherung'
'Restore': 'Wiederherstellung'
'Cold-standby (rolling backup)' : 'Cold-standby (rollende Sicherung)'
'Manual backups' : 'Manuelle Sicherung'
'Maildir' : 'Mail-Verzeichnis'
'mailcow-internal backups' : 'Interne mailcow Sicherungen'
'Recover accidentally deleted data' : 'Versehentlich gelöschte Daten wiederherstellen'
### Post Installation Tasks Section
'Post Installation Tasks': 'Post-Installationsaufgaben'
'Advanced SSL': 'Erweitertes SSL'
@ -254,16 +266,6 @@ plugins:
'Resend Quarantine Notifications' : 'Erneutes Senden von Quarantäne-Benachrichtigungen'
'Reset Passwords (incl. SQL)': 'Passwörter zurücksetzen (inkl. SQL)'
'Reset TLS certificates': 'TLS-Zertifikate zurücksetzen'
### Backup & Restore Section
'Backup & Restore': 'Sichern & Wiederherstellen'
'Component backup & restore' : 'Sicherung und Wiederherstellung von Komponenten'
'Backup': 'Sicherung'
'Restore': 'Wiederherstellung'
'Cold-standby (rolling backup)' : 'Cold-standby (rollende Sicherung)'
'Manual backups' : 'Manuelle Sicherung'
'Maildir' : 'Mail-Verzeichnis'
'mailcow-internal backups' : 'Interne mailcow Sicherungen'
'Recover accidentally deleted data' : 'Versehentlich gelöschte Daten wiederherstellen'
### Manual/Guides/Examples Section
'Manual/Guides/Examples': 'Anleitungen/Beispiele'
### mailcow UI Subsection
@ -365,16 +367,16 @@ plugins:
'firststeps-snat.md': 'post_installation/firststeps-snat.en.md'
'firststeps-ssl.md': 'post_installation/firststeps-ssl.en.md'
'firststeps-sync_jobs_migration.md': 'post_installation/firststeps-sync_jobs_migration.en.md'
'i_u_m_deinstall.md': 'i_u_m/i_u_m_deinstall.en.md'
'i_u_m_install.md': 'i_u_m/i_u_m_install.en.md'
'i_u_m_migration.md': 'i_u_m/i_u_m_migration.en.md'
'i_u_m_update.md': 'i_u_m/i_u_m_update.en.md'
'mailcow-dockerized-docs/i_u_m/i_u_m_install.md': 'i_u_m/i_u_m_install.en.md' # https://github.com/mailcow/mailcow-dockerized/pull/5196
'deinstall.md': 'maintenance/deinstall.en.md'
'install.md': 'getstarted/install.en.md'
'migration.md': 'maintenance/migration.en.md'
'update.md': 'maintenance/update.en.md'
'mailcow-dockerized-docs/i_u_m/i_u_m_install.md': 'getstarted/install.en.md' # https://github.com/mailcow/mailcow-dockerized/pull/5196
'model-acl.md': 'models/model-acl.en.md'
'model-passwd.md': 'models/model-passwd.en.md'
'model-sender_rcv.md': 'models/model-sender_rcv.en.md'
'prerequisite-dns.md': 'prerequisite/prerequisite-dns.en.md'
'prerequisite-system.md': 'prerequisite/prerequisite-system.en.md'
'prerequisite-dns.md': 'getstarted/prerequisite-dns.en.md'
'prerequisite-system.md': 'getstarted/prerequisite-system.en.md'
'third_party-borgmatic.md': 'third_party/borgmatic/third_party-borgmatic.en.md'
'third_party-exchange_onprem.md': 'third_party/exchange_onprem/third_party-exchange_onprem.en.md'
'third_party-gitea.md': 'third_party/gitea/third_party-gitea.en.md'
@ -433,14 +435,14 @@ plugins:
'client.md': 'client/client.en.md'
'debug.md': 'troubleshooting/debug.en.md'
'disable-greylisting.md': 'manual-guides/Rspamd/u_e-rspamd-disable-greylisting.en.md'
'install.md': 'i_u_m/i_u_m_install.en.md'
'migration.md': 'i_u_m/i_u_m_migration.en.md'
'install.md': 'getstarted/install.en.md'
'migration.md': 'maintenance/migration.en.md'
'restore.md': 'backup_restore/b_n_r-restore.en.md'
'rspamd-ui.md': 'manual-guides/Rspamd/u_e-rspamd-general.en.md'
'rspamd.md': 'manual-guides/Rspamd/u_e-rspamd-general.en.md'
'unauthenticated-relaying.md': 'manual-guides/Postfix/u_e-postfix-unauthenticated-relaying.en.md'
'uninstall.md': 'i_u_m/i_u_m_deinstall.en.md'
'update.md': 'i_u_m/i_u_m_update.en.md'
'uninstall.md': 'maintenance/deinstall.en.md'
'update.md': 'maintenance/update.en.md'
- search:
# separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
lang: