Installation

Die edulution Mail Lösung basiert auf Mailcow und bietet eine vollständige E-Mail-Infrastruktur für Schulen.

Übersicht

edulution-mail integriert Mailcow nahtlos in die edulution-Plattform und linuxmuster.net. Die Lösung bietet:

Automatische Synchronisation von Benutzer-Mailboxen, Aliase und Verteilergruppen aus Keycloak/Linuxmuster
Single Sign-On (SSO) über Keycloak für IMAP/POP3/SMTP-Login
Webmail-Zugriff über SOGo mit Keycloak-Authentifizierung
Soft-Delete-Funktion zum Schutz vor versehentlichem Datenverlust
Flexible Konfiguration über Umgebungsvariablen und Override-Dateien

Voraussetzungen

Für die Installation von edulution-mail benötigen Sie lediglich:

edulution-UI bereits installiert und konfiguriert
Ausreichend Speicherplatz auf dem Server

Automatische Konfiguration

Die Installation über edulution-UI richtet automatisch alle notwendigen Komponenten ein (Docker, Keycloak-Integration, Netzwerk, etc.). Es sind keine manuellen Vorarbeiten erforderlich.

Installation über edulution-UI

Die Installation von edulution-mail erfolgt direkt über die edulution-UI Administrationsoberfläche.

Installationsverzeichnis

Der Installer erstellt automatisch das Verzeichnis /srv/docker/edulution-mail, in dem alle Mailcow-Daten, Konfigurationsdateien und Logs gespeichert werden.

Speicherplatz-Bedarf:

Grundinstallation: ca. 2-3 GB
Pro Benutzer: ca. 3 GB (abhängig vom konfigurierten Quota)
Reserve: mind. 5 GB

Beispiel: Für 50 Benutzer sollten ca. 160 GB verfügbar sein (3 GB + 50×3 GB + 5 GB Reserve).

Schritt 1: E-Mails App installieren

Melden Sie sich als Administrator in der edulution-UI an
Navigieren Sie zu Einstellungen → App-Store
Klicken Sie auf die Kachel E-Mails
Unten erscheint ein + Button - klicken Sie darauf

App-Store - E-Mails auswählen

Schritt 2: Docker-Anwendung erstellen

Scrollen Sie nach unten zum Abschnitt Docker Anwendungen
Klicken Sie auf das + Symbol, um eine neue Docker-Anwendung zu erstellen
Ein Dialog öffnet sich zur Eingabe des Hostnames
Geben Sie den Hostname Ihrer edulution-Instanz ein (z.B. ihre-schule.de)
Klicken Sie auf Installieren

Hostname eingeben und Installation starten

Wichtig

Verwenden Sie den Hostname Ihrer edulution-Instanz, NICHT eine separate Mail-Domain wie mail.ihre-schule.de. Die E-Mail-Dienste werden über die edulution-URL bereitgestellt.

Was wird automatisch eingerichtet?

Der Installationsassistent kümmert sich vollautomatisch um:

E-Mail-Server - Mailcow wird heruntergeladen und konfiguriert
Single Sign-On - Benutzer können sich mit ihren edulution-Zugangsdaten anmelden
Automatische Synchronisation - Benutzer und Gruppen werden aus Keycloak übernommen
Benutzer-Quotas - Die in linuxmuster eingestellten Mail-Quotas werden automatisch übernommen
Webmail-Oberfläche - SOGo wird mit den edulution-Themes eingerichtet
Globales Adressbuch - Alle Benutzer sehen sich gegenseitig im Adressbuch
Netzwerk-Integration - Verbindung mit der edulution-Plattform

Installationsdauer

Die Installation dauert etwa 5-10 Minuten. Der Fortschritt wird in Echtzeit angezeigt.

Schritt 3: Proxy-Konfiguration hinzufügen

Nach Abschluss der Installation muss die Traefik Proxy-Konfiguration hinzugefügt werden, damit die E-Mail-Dienste über die edulution-URL erreichbar sind.

Bleiben Sie in Einstellungen → E-Mails
Scrollen Sie zum Abschnitt Proxy-Konfiguration
Aktivieren Sie den Expertenmodus
Fügen Sie folgende Konfiguration ein:

http:
  routers:
    edulution-sogo-mail:
      rule: PathPrefix(`/sogo-mail`)
      service: edulution-sogo
      entryPoints:
        - websecure
      tls: {}
      middlewares:
        - strip-sogo-mail-prefix

    edulution-sogo:
      rule: PathPrefix(`/SOGo`)
      service: edulution-sogo
      entryPoints:
        - websecure
      tls: {}
      middlewares:
        - sogo-headers
        - sogo-buffers

    edulution-active-sync:
      rule: PathPrefix(`/Microsoft-Server-ActiveSync`)
      service: edulution-sogo
      entryPoints:
        - websecure
      tls: {}

    edulution-autodiscover:
      rule: "(HostRegexp(`autodiscover.*`) || HostRegexp(`autoconfig.*`)) &&
        (PathPrefix(`/mail/config-v1.1.xml`) ||
        PathPrefix(`/autodiscover/autodiscover.xml`))"
      service: edulution-sogo
      entryPoints:
        - websecure
      tls: {}

  middlewares:
    strip-sogo-mail-prefix:
      stripPrefix:
        prefixes:
          - /sogo-mail

    sogo-headers:
      headers:
        customRequestHeaders:
          X-Forwarded-Proto: https
        frameDeny: false
        customResponseHeaders:
          X-Frame-Options: ALLOWALL

    sogo-buffers:
      buffering:
        maxRequestBodyBytes: 0
        memRequestBodyBytes: 131072
        maxResponseBodyBytes: 0
        memResponseBodyBytes: 524288
        retryExpression: IsNetworkError() && Attempts() <= 2

  services:
    edulution-sogo:
      loadBalancer:
        servers:
          - url: http://nginx/

Klicken Sie auf Speichern

Proxy-Konfiguration einfügen

Wichtig

Die Proxy-Konfiguration ist zwingend erforderlich! Ohne diese Konfiguration sind die E-Mail-Dienste nicht über die edulution-URL erreichbar.

edulution-mail beim Update mit aktualisieren

Beim Update der edulution-ui/edulution-api Container auf v2.0.156 oder höher muss edulution-mail auf v1.1.13 (oder höher) aktualisiert werden. edulution verbindet sich dann selbstständig mit dem Mailcow-Netzwerk (per docker network connect für den edu-api Container).

Optionales Aufräumen

Sobald edulution-mail das Mailcow-Netzwerk für edulution-api sichtbar macht, sind die alten imap/imaps-EntryPoints in Traefik und der zugehörige TCP-Block in der dyn. Mail-Konfiguration obsolet und können bereinigt werden. Details siehe Changelog & Config-Anpassungen.

Schritt 4: Docker-Anwendung starten

Scrollen Sie zum Abschnitt Docker Anwendungen
Klicken Sie auf Starten bei der edulution-mail Anwendung

E-Mail Docker-Anwendung starten

Schritt 5: Mailserver-Hosts konfigurieren

Damit die edulution-api direkt mit dem Mailserver kommunizieren kann, müssen IMAP- und SMTP-Server auf die internen Mailcow-Hostnamen gesetzt werden.

Bleiben Sie in Einstellungen → E-Mails
Scrollen Sie nach oben zum Abschnitt Mailserver
Tragen Sie folgende Werte ein:

Feld	Wert
URL (Mailcow-API)	`https://mailcowdockerized-nginx-mailcow-1`
API-Schlüssel	`***`
IMAP-Server	`dovecot`
IMAP Port	`993`
SMTP-Server	`postfix`
SMTP Port	`587`
Nicht zertifizierte Verbindungen ablehnen	aus

Klicken Sie oben rechts auf Speichern

URL-Feld nicht vergessen

Ohne den korrekten URL-Wert kann die edulution-UI nicht mit der Mailcow-API kommunizieren — z.B. Mailbox-Status, Sync-Trigger und Admin-Funktionen schlagen dann fehl.

Hintergrund

dovecot und postfix sind die internen Service-Namen der Mailcow-Container. Sie sind nur auflösbar, weil edulution-mail den edulution-api Container automatisch in das Mailcow-Netzwerk einbindet (siehe Versionskopplung).

Die Installation ist nun abgeschlossen und die E-Mail-Dienste werden gestartet.

Erstkonfiguration

Zugriff auf die Mailcow Administrationsoberfläche

Nach erfolgreicher Installation ist die Mailcow-Administrationsoberfläche über Port 8443 erreichbar:

https://ihre-server-ip:8443

Standard-Zugangsdaten:

Benutzername: admin
Passwort: moohoo

Sicherheitshinweis

Ändern Sie das Standard-Administratorpasswort sofort nach der ersten Anmeldung!

Es wird außerdem dringend empfohlen:

Den Zugriff auf Port 8443 auf interne Netzwerke zu beschränken
Eine Firewall-Regel einzurichten, die den öffentlichen Zugriff blockiert
Regelmäßige Passwortänderungen durchzuführen

Weitere Informationen zur Administration finden Sie unter Administration.

Webmail (SOGo) Zugriff

Das Webmail-Interface ist über Ihre edulution-Instanz erreichbar:

https://ihre-edulution-url.de/SOGo/so/

Benutzer können sich hier mit ihren edulution-Zugangsdaten anmelden.

Empfohlene Einstellungen nach der Installation

Nach der erfolgreichen Installation sollten Sie folgende Einstellungen vornehmen:

1. Admin-Passwort ändern

Wo: Mailcow Administrationsoberfläche (https://ihre-server-ip:8443)

Melden Sie sich mit den Standard-Zugangsdaten an
Klicken Sie oben rechts auf Admin
Wählen Sie Passwort ändern
Vergeben Sie ein sicheres, neues Passwort

Kritisch

Dies ist der wichtigste Sicherheitsschritt und sollte sofort nach der Installation durchgeführt werden!

2. E-Mail-Einstellungen konfigurieren

Wo: edulution-UI → Einstellungen → E-Mails

Hier können Sie folgende Einstellungen anpassen:

SOGo Theme - Wählen Sie zwischen hellem und dunklem Design
Benutzer-Mailformate - Konfigurieren Sie das Schema für E-Mail-Adressen
Quota-Einstellungen - Anpassen über Override-Konfiguration (siehe Konfiguration)

3. Sync-Gruppen überprüfen

Wo: Override-Konfiguration (/srv/docker/edulution-mail/mail.override.config)

Standardmäßig werden folgende Gruppen synchronisiert:

role-schooladministrator
role-teacher
role-student

Falls Sie andere Gruppen synchronisieren möchten, erstellen Sie eine Override-Konfiguration:

{
  "GROUPS_TO_SYNC": "role-teacher,role-student,ihre-custom-gruppe"
}

Weitere Details finden Sie unter Administration → Konfiguration.

4. Firewall-Regeln einrichten

Wo: Ihre Firewall-Lösung (z.B. Sophos, pfSense, ufw, iptables)

Stellen Sie sicher, dass folgende Ports in Ihrer Firewall freigegeben sind:

Öffentlich erreichbar (Internet):

Port	Protokoll	Dienst	Beschreibung
25	TCP	SMTP	E-Mail-Empfang
587	TCP	SMTP Submission	E-Mail-Versand (authentifiziert)
143	TCP	IMAP	E-Mail-Abruf (unverschlüsselt)
993	TCP	IMAPS	E-Mail-Abruf (verschlüsselt)
110	TCP	POP3	E-Mail-Abruf (unverschlüsselt)
995	TCP	POP3S	E-Mail-Abruf (verschlüsselt)
80	TCP	HTTP	Webmail (Weiterleitung zu HTTPS)
443	TCP	HTTPS	Webmail (verschlüsselt)

NUR intern erreichbar (Lokales Netzwerk):

Port	Protokoll	Dienst	Beschreibung
8443	TCP	Mailcow Admin	Administrationsoberfläche

Sicherheitshinweis

Beschränken Sie den Zugriff auf Port 8443 (Mailcow Admin) unbedingt auf interne Netzwerke oder VPN! Diese Oberfläche sollte NIEMALS öffentlich erreichbar sein.

5. DNS-Einträge überprüfen

Wo: Mailcow Administrationsoberfläche → Konfiguration → Diagnostics

Mailcow bietet eine integrierte DNS-Prüfung:

Melden Sie sich in der Mailcow Admin-Oberfläche an
Navigieren Sie zu Konfiguration
Wählen Sie Diagnostics
Klicken Sie auf DNS-Prüfung

Die Oberfläche zeigt Ihnen:

Welche DNS-Einträge erforderlich sind
Ob diese korrekt konfiguriert sind
Wie die Einträge konkret aussehen müssen (MX, SPF, DKIM, DMARC)

Automatische Generierung

Mailcow generiert alle notwendigen DNS-Einträge automatisch. Sie müssen diese nur noch in Ihrer DNS-Verwaltung eintragen.

Theme Switch Setup

Nur für ältere Installationen

Dieser Abschnitt ist nur relevant, wenn Sie edulution-installer < v1.0.0 verwendet haben.

Bei neueren Installationen (edulution-installer >= v1.0.0 und edulution-UI >= v1.6.14) ist dieser Schritt bereits automatisch konfiguriert.

Um aus der edulution-UI Administrationsoberfläche das SOGo-Theme umstellen zu können, muss ein zusätzlicher Volume-Mount eingerichtet werden.

Volume-Mount konfigurieren

Führen Sie folgenden Befehl aus, um den SOGo-Konfigurationsordner in den edulution-api Container zu mounten:

sed -i '/^\s*volumes:/a\      - /srv/docker/edulution-mail/mailcow/data/conf/sogo:/data/apps/mail/sogo/overrides:rw' /srv/docker/edulution-ui/docker-compose.yml

Theme auswählen

Nach der Konfiguration des Volume-Mounts:

Melden Sie sich in der edulution-UI als Administrator an
Navigieren Sie zu Einstellungen → E-Mails
Wählen Sie das gewünschte SOGo-Theme (Hell/Dunkel) aus

Die Theme-Änderung wird sofort für alle Benutzer wirksam.

Nächste Schritte

Nach der Installation können Sie:

E-Mail-Clients konfigurieren - Anleitungen für verschiedene Mail-Clients
Verteilerlisten einrichten - Projekt-basierte E-Mail-Verteiler
Mail-Migration durchführen - Bestehende E-Mails importieren
Erweiterte Administration - Mailserver konfigurieren und verwalten

Übersicht​

Voraussetzungen​

Installation über edulution-UI​

Schritt 1: E-Mails App installieren​

Schritt 2: Docker-Anwendung erstellen​

Was wird automatisch eingerichtet?​

Schritt 3: Proxy-Konfiguration hinzufügen​

Schritt 4: Docker-Anwendung starten​

Schritt 5: Mailserver-Hosts konfigurieren​

Erstkonfiguration​

Zugriff auf die Mailcow Administrationsoberfläche​

Webmail (SOGo) Zugriff​

Empfohlene Einstellungen nach der Installation​

1. Admin-Passwort ändern​

2. E-Mail-Einstellungen konfigurieren​

3. Sync-Gruppen überprüfen​

4. Firewall-Regeln einrichten​

5. DNS-Einträge überprüfen​

Theme Switch Setup​

Volume-Mount konfigurieren​

Theme auswählen​

Nächste Schritte​