Tipp: Sie können für alle Dateinamen und Verzeichnisse die automatische Vervollständigung mithilfe der Tab-Taste nutzen, sodass Sie nicht die kompletten Datei- oder Verzeichnisnamen manuell eintippen müssen.
Hinweis: Für die gesamte Anleitung wird beispielhaft die Domain "testdomain.de" verwendet. Immer, wenn "testdomain.de" erwähnt wird, müssen Sie an diesen Stellen selbstverständlich Ihre Domain angeben.
Diese Anleitung wurde am 03.04.2023 zuletzt überprüft und aktualisiert.
Vorbereitungen
Bevor Sie mit der eigentlichen Installation von Mailcow beginnen können, müssen Sie erst einige Vorbereitungen treffen, welche hauptsächlich die DNS-Einstellungen Ihrer Domain, die Sie für den Empfang und Versand von E-Mails nutzen möchten, betreffen. Führen Sie dazu die folgenden Schritte durch:
- Der Hostname Ihres Servers sollte bestenfalls "mail" und der FQDN entsprechend "mail.testdomain.de" lauten.
- Fügen Sie einen A-Record für die Subdomain "mail" (mail.testdomain.de) hinzu und lassen diesen auf die IP-Adresse des Mailservers zeigen.
- Fügen Sie einen MX-Record für Ihre Domain hinzu und setzen den Wert auf die soeben angelegte Mail-Subdomain (mail.testdomain.de) mit der Priorität 10.
- Definieren Sie jeweils einen CNAME-Record für die Subdomains "autodiscover" sowie "autoconfig" und setzen das Ziel beider CNAME-Records ebenfalls auf die Mail-Subdomain (mail.testdomain.de).
- Fügen Sie nun einen TXT-Record für Ihre Domain hinzu und setzen den Wert auf "v=spf1 mx ~all", damit der Server, welcher im MX-Record angegeben ist (der Mailserver, auf dem Mailcow installiert wird) zum Senden von E-Mails mit Ihrer Domain als Absender berechtigt wird. Das "~all" bedeutet, dass andere Server keine E-Mails von Ihrer Domain senden dürften, aber diese E-Mails trotzdem noch ankämen (Softfail).
- Definieren Sie einen PTR-Record (Reverse DNS) für die IP-Adresse Ihres Servers und setzen Sie den Wert auf den FQDN Ihres Servers (i.d.R. "mail.testdomain.de"). Diesen PTR-Record können Sie bei vielen guten Server-Hostern (wie beispielsweise bei Contabo) direkt im Webinterface setzen, bei einigen Anbietern hingegen müssen Sie hierfür eine E-Mail bzw. ein Support-Ticket schreiben.
Installation von Mailcow
- Falls Sie es noch nicht getan haben, laden Sie das Programm "PuTTY" herunter.
- Verbinden Sie sich mithilfe von PuTTY via SSH mit Ihrem Root- oder vServer. Hierfür öffnen Sie PuTTY und geben im Textfeld "Host Name (or IP address)" die Domain oder IP-Adresse Ihres Servers ein. Klicken Sie anschließend unten auf "OK".
- Aktualisieren Sie nun Ihre Paketlisten mit dem Befehl
apt update
. - Installieren Sie jetzt möglicherweise verfügbare Updates der auf Ihrem Server bereits installieren Pakete mit dem Befehl
apt upgrade -y
. - Als nächstes installieren Sie Pakete, die für die weiteren Installationen benötigt werden, mit folgendem Befehl:
apt install curl nano git apt-transport-https ca-certificates gnupg2 software-properties-common -y
- Installieren Sie Docker, indem Sie folgende Schritte durchführen:
- Fügen Sie mithilfe des folgenden Befehls den für die Docker-Paketquelle benötigen Key hinzu:
Für Debian:curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Für Ubuntu:curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
- Fügen Sie mit diesem Befehl nun die für die Installation von Docker benötigte Paketquelle hinzu:
Für Debian:echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list
Für Ubuntu:echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list
- Aktualisieren Sie nun erneut Ihre Paketlisten mit dem Befehl
apt update
. - Installieren Sie nun Docker, indem Sie den Befehl
apt install docker-ce docker-ce-cli -y
ausführen.
- Fügen Sie mithilfe des folgenden Befehls den für die Docker-Paketquelle benötigen Key hinzu:
- Laden Sie nun Docker-Compose mit dem Befehl
curl -L https://github.com/docker/compose/releases/download/v$(curl -Ls https://www.servercow.de/docker-compose/latest.php)/docker-compose-$(uname -s)-$(uname -m) > /usr/local/bin/docker-compose
herunter. - Vergeben Sie mithilfe des Befehls
chmod +x /usr/local/bin/docker-compose
nun noch die Rechte zum Ausführen von Docker-Compose. - Wechseln Sie mit dem Befehl
cd /opt
in das Verzeichnis "/opt" - Laden Sie Mailcow bzw. den Master Branch des entsprechenden Repositorys jetzt mit folgendem Befehl herunter:
git clone https://github.com/mailcow/mailcow-dockerized
- Begeben Sie sich mit dem Befehl
cd mailcow-dockerized
in das Mailcow-Verzeichnis. - Nun muss die Konfigurationsdatei für Mailcow generiert werden. Nutzen Sie hierzu den Befehl
./generate_config.sh
. Sie werden anschließend nach einem FQDN gefragt. Geben Sie hier den FQDN Ihres Servers an (i.d.R. "mail.testdomain.de") und bestätigen Sie die Eingabe mit der Enter-Taste. Die Abfrage nach der Zeitzone können Sie einfach mit Enter bestätigen, da standardmäßig "Europe/Berlin" erkannt werden sollte. Wählen Sie abschließend den Branch "master", indem Sie "1" eingeben und mit Enter bestätigen. - Die Konfigurationsdatei ist nun generiert. Sie können diese mit dem Befehl
nano mailcow.conf
optional anpassen, wenn Sie beispielsweise bereits einen Webserver installiert haben und Sie deswegen die Ports ("HTTP_PORT" und "HTTPS_PORT") des Mailcow-Webservers ändern möchten. Zudem können Sie z.B. den Wert des Parameters "SKIP_LETS_ENCRYPT" auch auf "y" setzen, falls Sie nicht möchten, dass automatisch ein SSL-Zertifikat bei Let's Encrypt beantragt wird. Änderungen an der Konfiguration können Sie speichern, indem Sie STRG + X, danach die "Y"-Taste und anschließend Enter drücken. - Laden Sie die für Mailcow benötigten Images mit folgendem Befehl herunter:
docker-compose pull
- Starten Sie den Mailcow-Container nun, indem Sie den Befehl
docker-compose up -d
ausführen. -
Mailcow beantragt automatisch ein Let's Encrypt SSL-Zertifikat für die Domain, welche als Hostname gesetzt ist ("acme-mailcow"-Container), sofern diese Funktion nicht explizit über die Konfigurationsdatei deaktiviert wurde. Somit können Sie das Mailcow-Webinterface per HTTPS aufrufen. Um HTTP-Anfragen automatisch zu HTTPS umzuleiten, führen Sie folgende Schritte durch:
- Erstellen Sie eine Nginx-Konfigurationsdatei mithilfe des Befehls
nano /opt/mailcow-dockerized/data/conf/nginx/redirect.conf
. - Fügen Sie in diese Konfigurationsdatei nun folgenden Inhalt ein:
- Speichern Sie Ihre Änderungen der Konfiguration, indem Sie STRG + X, danach die "Y"-Taste und anschließend Enter drücken.
- Starten Sie Nginx daraufhin neu, indem Sie den Befehl
docker-compose restart nginx-mailcow
ausführen. Nun werden HTTP-Anfragen automatisch zu HTTPS umgeleitet.
- Erstellen Sie eine Nginx-Konfigurationsdatei mithilfe des Befehls
Einrichtung von Mailcow
- Rufen Sie das Mailcow-Webinterface unter der Domain Ihres Servers im Browser via HTTPS auf. Falls Sie den Webserver-Port in der Konfigurationsdatei geändert haben, müssen Sie diesen nun natürlich mit angeben (z.B. "https://mail.testdomain.de:4433").
- Loggen Sie sich mit dem Benutzernamen "admin" und dem Passwort "moohoo" ein.
- Klicken Sie oben im Menü auf "System" und dann auf "Konfiguration".
- Klicken Sie nun unter "Administrator bearbeiten" rechts neben der Zeile des Benutzers "admin" auf "Bearbeiten".
- Ändern Sie das Passwort des Administrator-Benutzers und passen Sie, wenn gewünscht, auch den Benutzernamen an. Klicken Sie danach auf den Button "Änderungen speichern".
- Wechseln Sie nun zur E-Mail Konfiguration, indem Sie oben auf "E-Mail" und anschließend auf "Konfiguration" klicken.
- Der Reiter "Domains" ist bereits ausgewählt. Fügen Sie hier Ihre Domain durch einen Klick auf den Button "Domain hinzufügen" hinzu. Geben Sie im Dialog, welcher erscheint, die Domain im Textfeld "Domain" und eine Beschreibung im Textfeld "Beschreibung" an. Die restlichen Einstellungen (z.B. die maximale Anzahl oder Größe der Postfächer) können Sie anpassen, jedoch sollten die Standard-Werte i.d.R. ausreichend sein. Klicken Sie anschließend auf den Button "Domain hinzufügen und SOGo neustarten".
- Wechseln Sie zum Reiter "Mailboxen", klicken Sie dort erneut auf "Mailboxen" und fügen mithilfe des Buttons "Mailbox hinzufügen" eine neue Mailbox (Postfach) hinzu. Dabei müssen Sie folgende Angaben machen:
- Benutzername: Linker Teil der E-Mail Adresse (vor dem "@")
- Domain: Domain, zu der das Postfach gehört
- Vor- und Nachname: Vor- und Nachname des Postfach-Nutzers
- Speicherplatz (MiB): Speicherplatz für das Postfach (standardmäßig 3072 MiB)
- Passwort: Passwort des Postfach-Nutzers
- Mailcow ist nun grundsätzlich eingerichtet. Es ist jedoch empfehlenswert, weitere Konfigurationen wie z.B. die DKIM-Konfiguration durchzuführen. Die DKIM-Konfiguration wird in dieser Anleitung im nächsten Schritt erklärt. Für weitere Informationen ist u.a. die Dokumentation von Mailcow hilfreich.
DKIM-Konfiguration
- Loggen Sie sich in das Mailcow-Webinterface ein und klicken Sie oben im Menü auf "System" und anschließend auf "Konfiguration".
- Klicken Sie auf den Reiter "Einstellungen" und danach auf "ARC/DKIM-Keys"
- Für jede konfigurierte Domain wird bereits automatisch ein DKIM-Key mit dem Selektor "dkim" und einer Schlüssellänge von 2048 Bit generiert. Kopieren Sie den Inhalt der Textbox oben (Public-Key passend zur Domain, beginnend mit "v=DKIM1;k=rsa;t=s;s=email;p=") unter "ARC/DKIM-Keys".
- Fügen Sie abschließend einen TXT-Eintrag für "dkim._domainkey.testdomain.de" (passend zum gewählten DKIM-Selektor) in den DNS-Einstellungen Ihrer Domain hinzu und setzen Sie den vorhin kopierten Inhalt aus der Textbox als Wert des TXT-Eintrags.
Nutzung des Webmail-Clients "SOGo"
Mailcow liefert - unabhängig von der Möglichkeit, normale E-Mail Clients wie Thunderbird, Outlook o.ä. zu nutzen - praktischerweise direkt einen Webmail-Client mit. Somit können Sie Ihre E-Mails folgendermaßen auch direkt im Browser abrufen:
- Klicken Sie im Menü des Mailcow-Webinterfaces oben auf "Apps" und dann auf "Webmail" oder rufen Sie den Webmail-Client direkt auf, indem Sie an die Domain Ihres Servers "/SOGo" anhängen.
- Loggen Sie sich nun ein. Geben Sie hierfür als Benutzernamen die vollständige E-Mail Adresse des Postfachs und als Passwort das entsprechende Passwort ein.
- Sie sollten im Posteingang bereits eine E-Mail sehen (Erstellung eines persönlichen Kalenders) und können den Webmail-Client nun verwenden.
Einrichtung in E-Mail Clients (z.B. Thunderbird)
Sie können Ihrer Postfächer natürlich auch zu herkömmlichen E-Mail Clients wie beispielsweise Thunderbird, Outlook oder Apple Mail hinzufügen. Im Normalfall müssen Sie nur den Benutzernamen (E-Mail Adresse des Postfachs) und das Passwort angeben, die Server-Einstellungen sollten automatisch ermittelt werden. Falls dies nicht funktioniert, dann verwenden Sie die folgenden Server-Einstellungen:
Server | Protokoll | Server-Adresse | Port | SSL | Authentifizierung |
---|---|---|---|---|---|
Posteingangsserver | IMAP | FQDN des Mailservers (i.d.R. mail.testdomain.de) | 993 | SSL/TLS | Passwort, normal |
Postausgangsserver | SMTP | FQDN des Mailservers (i.d.R. mail.testdomain.de) | 587 | STARTTLS | Passwort, normal |