, , , ,

Stalwart Mail Server v1 mit Docker installieren: DNS, TLS & Sicherheit

•

min Lesezeit

•

Letzte Änderung

Stalwart Mail Server v1 installieren: Diese Anleitung richtet einen neuen Mailserver mit Docker Compose ein: SMTP, IMAP, eigene Maildomain, DNS und HTTPS. Du prüfst anschließend Versand und Empfang mit echten Testnachrichten.

Wichtig: Ein vorhandener Stalwart-0.16-Mailserver benötigt einen gesonderten Migrationsplan mit vollständigem Backup. Die hier gezeigten Installationsbefehle sind nicht als Upgrade einer produktiven Installation gedacht.

Stand: 3. November 2026. Die frühere Version dieses Entwurfs bezog sich auf v0.16 und nutzte veraltete Pfade und Images. Die folgende Neuinstallationsanleitung basiert auf der aktuellen offiziellen Stalwart-Docker-Dokumentation. Die Befehle sind für einen neuen Server gedacht, nicht für einen bestehenden Mailserver mit Postfächern.

1. Was ist Stalwart und wie ist ein Mailserver aufgebaut?

Stalwart ist ein selbst hostbarer Mailserver für SMTP-E-Mail-Transport und moderne Client-Protokolle wie IMAP/JMAP. Anders als Webanwendungen benötigt er neben HTTP/HTTPS mehrere spezifische TCP-Ports, einen erreichbaren Mailhost, saubere DNS-Einträge und eine vertrauenswürdige öffentliche IP-Reputation. Ein Cloudflare-Tunnel für Webseiten ersetzt nicht automatisch die SMTP-Erreichbarkeit auf Port 25.

2. Voraussetzungen und Portfreigaben

  • Ein Linux-Server mit Docker Engine und Docker Compose Plugin, Root-/sudo-Zugriff und dauerhaft erreichbarer öffentlicher IPv4- oder IPv6-Adresse.
  • Die eigene Domain und Kontrolle über ihre autoritative DNS-Zone sowie idealerweise Reverse-DNS/PTR beim Serveranbieter.
  • Port 25/TCP in beide Richtungen für den Mailaustausch. Viele Anbieter blockieren diesen Port standardmäßig – vorher prüfen.
  • Für die offizielle Standardkonfiguration TCP 465 (Submission über TLS), 993 (IMAPS), 995 (POP3S), 4190 (ManageSieve) und 443 (HTTPS/JMAP/WebUI). Benötigte Listener und Ports sind abhängig von deiner tatsächlichen Konfiguration.
  • Der Erstinstallations-Port 8080 soll nur über 127.0.0.1 erreichbar sein; der Setup-Assistent ist nicht für das öffentliche Internet gedacht.
sudo docker version
sudo docker compose version
sudo ss -lntup | grep -E ":(25|443|465|993|995|4190|8080)\b" || true

Portkonflikte vermeiden: Wenn Pangolin, Coolify, Apache oder Nginx auf diesem Host bereits TCP 443 belegen, kann Stalwart den gleichen Host-Port nicht separat binden. Für den Mailserver wird dann eine bewusst konfigurierte Aufteilung mit einem vorgeschalteten Proxy, eigener IP oder separatem Host benötigt. Für SMTP- und IMAP-Verbindungen reicht ein HTTP-Reverse-Proxy allein nicht aus.

3. Docker Compose für Stalwart v1 erstellen

Lege ein eigenes Arbeitsverzeichnis an. Der aktuelle offizielle v1-Container heißt stalwartlabs/stalwart:v1 und verwendet persistente Volumes für /etc/stalwart und /var/lib/stalwart. Verwende bei einer bestehenden 0.16-Installation nicht einfach dieses Compose-Dokument über deinen alten Datenordner.

mkdir -p ~/stalwart-v1
cd ~/stalwart-v1
nano compose.yaml
services:
  stalwart:
    image: stalwartlabs/stalwart:v1
    container_name: stalwart
    init: true
    restart: unless-stopped
    ports:
      - "25:25"
      - "465:465"
      - "993:993"
      - "995:995"
      - "4190:4190"
      - "443:443"
      - "127.0.0.1:8080:8080"
    volumes:
      - stalwart-etc:/etc/stalwart
      - stalwart-data:/var/lib/stalwart
volumes:
  stalwart-etc:
  stalwart-data:

Die Compose-Datei ist die vom Projekt empfohlene Ausgangskonfiguration für einen einzelnen Server. Die Zuordnung 127.0.0.1:8080:8080 sorgt dafür, dass die Einrichtungsoberfläche nur lokal am Host erreichbar ist. Öffne Port 8080 nicht in der öffentlichen Firewall.

4. Container starten und Administrator-Passwort finden

cd ~/stalwart-v1
sudo docker compose up -d
sudo docker compose ps
sudo docker logs --tail=120 stalwart

Erfolgskontrolle: Docker meldet den Container als laufend und nach erfolgreicher integrierter Prüfung als healthy. Im Bootstrap-Modus findest du das temporäre Administratorpasswort in der aktuellen Log-Ausgabe; es kann sich nach einem Neustart ändern. Niemals Screenshots oder Logs mit diesem Passwort veröffentlichen. Der sichere Zugriff auf den Einrichtungsassistenten erfolgt im nächsten Schritt ausschließlich über den lokalen SSH-Tunnel.

Beim ersten Start ohne Konfiguration befindet sich Stalwart im Bootstrap-Modus und erzeugt ein temporäres Administratorpasswort in seiner Ausgabe. Kopiere dieses nur in einen sicheren Passwortmanager und teile die Log-Ausgabe nicht unredigiert. Das Setup auf Port 8080 hat noch keine reguläre Transportverschlüsselung.

5. Sicher per SSH zum Einrichtungsassistenten

Öffne auf deinem eigenen Rechner einen SSH-Tunnel zum Stalwart-Host. Dadurch wird die nur lokal erreichbare Setup-Oberfläche geschützt weitergeleitet:

ssh -L 8080:127.0.0.1:8080 BENUTZER@DEIN-SERVER

Öffne im Browser deines eigenen Rechners http://127.0.0.1:8080/admin. Melde dich mit dem temporären Benutzernamen admin und dem zuletzt ausgegebenen Bootstrap-Passwort an. Der Assistent fragt nach Server-Hostname (mail.example.com), erster Maildomain (example.com) und weiteren Einstellungen. Lass TLS- und DKIM-Erstellung aktiviert und übernimm die DNS-Angaben aus deiner tatsächlichen Einrichtung.

Stalwart Setup-Wizard: Server-Hostname, Standarddomain, TLS-Zertifikat und DKIM aktivieren

Screenshot: offizieller Stalwart-v1-Einrichtungsassistent; die abgebildeten Beispiel-Domains sind Demonstrationswerte.

6. Domain, DNS und Mailzustellung korrekt konfigurieren

Für eine beispielhafte Domain example.com und den Server mail.example.com benötigst du mindestens einen öffentlichen A-/AAAA-Eintrag für den Mailhost und einen MX-Eintrag für die Domain. Die Beispiel-IP 203.0.113.20 ist eine reservierte Dokumentationsadresse.

A     mail      203.0.113.20
MX    @         mail.example.com.     Priorität 10
TXT   @         v=spf1 mx -all
TXT   _dmarc    v=DMARC1; p=none; rua=mailto:dmarc@example.com

Wichtig: Der SPF-Beispielwert erlaubt nur die MX-Hosts. Wenn deine Domain außerdem andere legitime Absender (Newsletter, weitere Mailserver etc.) verwendet, muss die Richtlinie passend ergänzt werden. Starte bei DMARC mit Monitoring, prüfe echte Reports und wechsle erst danach auf eine strengere Richtlinie wie quarantine oder reject. Die Adresse dmarc@example.com muss vorhanden sein.

DKIM-Schlüssel und die korrekten DNS-Hostnamen werden in der Stalwart-Administration erzeugt beziehungsweise im Assistenten ausgegeben. Übertrage genau diese TXT-Records. Der PTR-/Reverse-DNS-Eintrag deiner öffentlichen IP sollte beim Hosting-Anbieter auf mail.example.com zeigen. Bei Cloudflare muss die normale Mailhost-Adresse DNS only bleiben; Cloudflares Standard-HTTP-Proxy transportiert keine Mailprotokolle auf Port 25, 465 oder 993.

dig @1.1.1.1 mail.example.com A +short
dig @1.1.1.1 example.com MX +short
dig @1.1.1.1 example.com TXT +short
dig -x 203.0.113.20 +short

7. Setup abschließen, neu starten und Admin-Oberfläche öffnen

Der Assistent speichert die Konfiguration, danach benötigt Stalwart einen Neustart, um den regulären Mailbetrieb aufzunehmen. Die offizielle Dokumentation zeigt hierfür:

sudo docker compose restart stalwart
sudo docker compose ps
sudo docker logs --tail=100 stalwart

Rufe nach erfolgreicher DNS- und TLS-Konfiguration https://mail.example.com/admin auf. Die Benutzerkontenverwaltung ist unter /account erreichbar. Warte bei einer vorübergehenden Zertifikatswarnung auf eine gültige Zertifikatsausstellung und prüfe die Ursachen; bestätige eine unbekannte Zertifikatswarnung nicht einfach weg.

Stalwart Mail Security-Dashboard: Sperren, Warnungen, Login- und Zustellstatistiken

Beispiel-Screenshot aus der öffentlichen Stalwart-Support-Dokumentation. Darstellung und Menüpunkte können sich je nach Version unterscheiden.

8. E-Mail-Adressen erstellen und SMTP/IMAP testen

  • In der Adminoberfläche die gewünschte Maildomain prüfen und ein Testbenutzerkonto erstellen.
  • Mit einem E-Mail-Programm eine IMAP-Verbindung auf mail.example.com:993 (TLS) und eine SMTP-Verbindung auf mail.example.com:465 (TLS) einrichten.
  • Eine Testmail an einen anderen Anbieter versenden, dort Kopfzeilen auf SPF/DKIM/DMARC-Resultate kontrollieren und auf die Nachricht antworten.
  • Fehler in den Stalwart-Logs, DNS-Einträgen, der SMTP-Queue und gegebenenfalls in der Firewall des Providers prüfen.

Dass eine Testmail verschickt werden kann, beweist noch keine gute Zustellbarkeit. Auch IP-Reputation, Reverse-DNS, TLS, Anti-Spam-Richtlinien und das tatsächliche Verhalten anderer Mailanbieter spielen eine Rolle.

9. Stalwart v0.16 auf v1 aktualisieren – Achtung Migration

Die alte Installation stalwart/stalwart-mail:0.16 verwendet andere Images und teilweise andere Konfigurations-/Speicherstrukturen. Ein Austausch des Image-Namens ist daher keine sichere Migration. Erstelle vollständige Backups, überprüfe den Migrationsstand und folge dem offiziellen Migrationsverfahren inklusive Vorbereitung, Daten-/Konfigurationsübernahme und Rollback.

Für bereits betriebene v0.16-Server gilt die separate offizielle Migration von v0.16 auf v1. Diese Anleitung beschreibt eine Neuinstallation; verwende sie nicht als Upgrade-Skript für bestehende Postfächer.

10. Sicherheit, Backups und Fehlerbehebung

  • Port 8080 nur lokal betreiben und nach erfolgreichem Setup nicht mehr öffentlich routen.
  • Die beiden benannten Volumes stalwart-etc und stalwart-data regelmäßig sichern und Restore testen.
  • Administrative Zugriffe schützen, MFA aktivieren und SMTP/IMAP-Logs sowie Queue und Speicherplatz überwachen.
  • Mail-DNS niemals ungetestet verändern: MX, SPF, DKIM, DMARC und PTR müssen zueinander passen.
  • Ein Proxy für HTTPS darf nicht mit einem vollständigen Mail-Proxy verwechselt werden.

Fehler: Setup-Seite lässt sich nicht öffnen

Prüfe Containerstatus und die Bindung 127.0.0.1:8080. Der SSH-Tunnel muss aufgebaut bleiben. Prüfe, ob Port 8080 auf deinem lokalen Rechner bereits durch einen anderen Prozess belegt ist.

Fehler: Kein TLS-Zertifikat

Prüfe DNS und die vom Assistenten gewählte ACME-Methode. Der gewählte Challenge-Pfad muss tatsächlich bei der korrekten Instanz ankommen. Mögliche Konflikte mit Pangolin, Coolify oder vorgeschalteten Cloudflare-Routen müssen behoben werden.

Fehler: E-Mails kommen nicht an

Teste öffentliche TCP-25-Erreichbarkeit, MX- und PTR-Records, Firewall, Mailqueue und die Empfängerzustellungsprotokolle. Cloudflare DNS-only ist für den normalen Mailhost erforderlich.

Häufige Fragen

Kann ich Stalwart hinter Pangolin betreiben?

Die HTTP-Adminoberfläche lässt sich unter passenden Sicherheitsvoraussetzungen per Reverse Proxy schützen. SMTP-/IMAP-Dienste benötigen hingegen passende TCP/TLS-Weiterleitung und dürfen nicht als normale HTTP-Ressourcen behandelt werden.

Sind alle Ports öffentlich nötig?

Nur die Protokolle, die du tatsächlich betreiben willst. Bei der offiziellen Standard-Compose-Datei sind mehrere typische Mailports enthalten; beschränke offene Ports und Listener auf deine Anforderungen, ohne SMTP-Zustellung versehentlich zu blockieren.

Quellen und weitere Anleitungen


Schreiben Sie einen Kommentar

Ihre E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert