2mail — SMTP-Relay aus belgischer Infrastruktur

SMTP für TYPO3 — die E-Mails Ihrer Website, die ankommen

TYPO3 versendet seine E-Mails über den Transport, der in den Installationseinstellungen festgelegt ist. Standardmäßig ist das die lokale Mailfunktion des Servers — ohne Authentifizierung und Reputation, sodass Formularübermittlungen und E-Mails zum Zurücksetzen bei Gmail und Outlook regelmäßig im Spam landen.

TYPO3 kann diesen Transport direkt auf SMTP stellen, ohne zusätzliche Erweiterung. Sie tragen Server, Port, Verschlüsselung und Zugangsdaten in den MAIL-Einstellungen der Installation ein, und alles, was TYPO3 versendet — auch Formular- und Workflow-E-Mails von Erweiterungen — läuft ab sofort über Ihr Relay.

Warum es ohne Relay schiefgeht

TYPO3 dient großen mehrsprachigen Websites von Unternehmen und Verwaltungen, oft mit Formularen, die einen echten Vorgang auslösen: eine Anmeldung, eine Angebotsanfrage, eine Bewerbung. Kommt die Bestätigung nicht an, ruft der Antragsteller an — oder füllt das Formular ein zweites Mal aus, und Sie haben doppelte Vorgänge. Die Nachricht geht sehr wohl ab, aber nichts belegt, dass sie von Ihrer Domain stammt.

SMTP in TYPO3 einrichten

1

Zugangsdaten abrufen

Melden Sie sich in Ihrem 2mail-Konto an und rufen Sie dort Ihren SMTP-Server, Benutzernamen und Ihr Passwort ab.

2

In TYPO3 eintragen

Die Mail-Konfiguration von TYPO3 liegt in den Installationseinstellungen unter den MAIL-Schlüsseln. Stellen Sie den Transport auf SMTP, tragen Sie den Server mit Port ein, wählen Sie die Verschlüsselung und geben Sie Benutzername und Passwort an. Setzen Sie auch die Standard-Absenderadresse und den Absendernamen auf Ihre eigene Domain. Das Install Tool bietet eine Test-E-Mail — senden Sie sie an eine externe Adresse bei einem großen Anbieter.

3

Domain authentifizieren

Sorgen Sie dafür, dass SPF, DKIM und DMARC für Ihre Domain korrekt gesetzt sind, damit Empfänger verifizieren können, dass die Mail von Ihnen stammt.

4

Testen

Senden Sie von Ihrer Plattform aus eine Testnachricht an eine Adresse bei einem großen Provider und prüfen Sie, ob sie im Posteingang ankommt und nicht im Spam-Ordner.

Die Felder, die TYPO3 abfragt

Jede Plattform nennt sie etwas anders, aber es geht immer um dieselben fünf. Die konkreten Werte sind kontogebunden und finden Sie in Ihrem 2mail-Konto — rufen Sie sie dort ab, damit Sie sicher die richtigen verwenden.

Feld Was Sie eintragen
SMTP-Server (Host)Der Servername aus Ihrem 2mail-Konto.
PortDer Port, der zu Ihrer gewählten Verschlüsselung gehört; Ihr Konto zeigt, welcher.
VerschlüsselungTLS. Senden Sie nie unverschlüsselt — sonst gehen Ihre Zugangsdaten lesbar über die Leitung.
BenutzernameDer SMTP-Login Ihres 2mail-Kontos.
PasswortDas zugehörige Passwort. Verwenden Sie nie das Passwort eines Mitarbeiterpostfachs.

SMTP-Konfiguration für TYPO3 im Code

Funktionierende Beispiele für Port 587 mit STARTTLS, direkt zum Übernehmen. Ersetzen Sie die Absenderadresse durch eine Adresse auf Ihrer eigenen Domain und prüfen Sie Servername und Login in Ihrem 2mail-Konto. Das Passwort gehört in eine Umgebungsvariable — nie in den Code und nie in die Versionsverwaltung.

Die MAIL-Einstellungen in additional.php

Tragen Sie die SMTP-Daten in die zusätzliche Konfigurationsdatei ein und nicht in settings.php: Letztere wird vom Install Tool neu geschrieben, und ein getenv()-Aufruf überlebt das nicht. Benutzername und Passwort kommen so aus Umgebungsvariablen des Servers und bleiben außerhalb der Versionsverwaltung. Achten Sie auf transport_smtp_encrypt: In den aktuellen TYPO3-Versionen ist das ein Boolean, der auf Port 587 false sein muss — STARTTLS erfolgt dann automatisch. Nur sehr alte Versionen (bis einschließlich 9) erwarteten hier die Zeichenkette tls.

<?php
// config/system/additional.php
// (older installations: typo3conf/AdditionalConfiguration.php)

$GLOBALS['TYPO3_CONF_VARS']['MAIL'] = array_replace(
    $GLOBALS['TYPO3_CONF_VARS']['MAIL'],
    [
        'transport' => 'smtp',
        'transport_smtp_server' => 'relay.2mail.eu:587',   // host AND port, in one value
        'transport_smtp_encrypt' => false,                 // false on 587 = STARTTLS; true = TLS from the first byte (465)
        'transport_smtp_username' => getenv('SMTP_USERNAME'),
        'transport_smtp_password' => getenv('SMTP_PASSWORD'),
        'defaultMailFromAddress' => 'noreply@example.com',
        'defaultMailFromName' => 'Example',
    ]
);

Test-E-Mail: Install Tool oder MailMessage

Die schnellste Prüfung steckt im Backend: Admin Tools → Environment → Test Mail Setup sendet eine Nachricht mit genau den Einstellungen, die tatsächlich gelten. Wenn Sie aus Ihrer eigenen Erweiterung testen möchten, genügt die MailMessage-Klasse von TYPO3 — derselbe Weg, den Formulare und Workflow-E-Mails nehmen.

use TYPO3\CMS\Core\Mail\MailMessage;
use TYPO3\CMS\Core\Utility\GeneralUtility;

// No from(): TYPO3 falls back to defaultMailFromAddress / defaultMailFromName.
$mail = GeneralUtility::makeInstance(MailMessage::class);
$mail
    ->to('you@example.org')
    ->subject('SMTP test')
    ->text('Sent through the 2mail SMTP relay.')
    ->send();

Welche Mails TYPO3 sendet

Sobald das Relay eingerichtet ist, laufen diese alle über 2mail — Sie müssen sie nicht einzeln konfigurieren.

Formularübermittlungen und -bestätigungen
Passwort-Zurücksetzen für Backend- und Frontend-Benutzer
Workflow-Benachrichtigungen für Inhalte, die auf Freigabe warten
System- und Sicherheitsalarme an die Administratoren
Geplante Berichte und Newsletter aus Erweiterungen

Stolperfallen bei TYPO3

Einstellungen in der falschen Ebene

TYPO3 liest die Installationseinstellungen aus mehreren Ebenen: der System-Konfigurationsdatei und einer zusätzlichen Datei, die sie überschreibt. Wenn Sie die SMTP-Daten in eine Ebene eintragen, während die andere noch den alten Transport enthält, gewinnt Letztere. Prüfen Sie im Install Tool, welcher Wert tatsächlich gilt.

Server und Port gehören zusammen

TYPO3 erwartet Server und Port gemeinsam in der Transport-Einstellung. Vergessen Sie den Port, fällt TYPO3 auf einen Standardwert zurück, der nicht zu Ihrer Verschlüsselung passt — und die Verbindung bleibt hängen oder wird sofort getrennt. Port 587 mit STARTTLS ist die sichere Wahl.

Staging mit denselben Daten

Wird die Konfiguration über die Versionsverwaltung ausgerollt, sendet eine Test- oder Staging-Umgebung mit denselben Zugangsdaten — an echte Adressen aus einer kopierten Datenbank. Verwenden Sie pro Umgebung eigene Zugangsdaten, damit Sie die Testumgebung separat abschalten können.

Häufige Fehlermeldungen bei TYPO3

Die Meldungen, die Sie sehen, wenn Host, Port, Verschlüsselung oder Login nicht stimmen — im Wortlaut, damit Sie sie in Ihrem Log wiedererkennen, mit Ursache und Lösung daneben.

Meldung Ursache Lösung
Connection could not be established with host "relay.2mail.eu:25": stream_socket_client(): Unable to connect to relay.2mail.eu:25 (Connection timed out) In transport_smtp_server steht nur der Servername, ohne Port. TYPO3 fällt dann auf Port 25 zurück, und der ist bei den meisten Hostern und Cloud-Plattformen für ausgehenden Verkehr gesperrt. Schreiben Sie Server und Port zusammen in einen Wert: relay.2mail.eu:587.
Connection could not be established with host "ssl://relay.2mail.eu:587": stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages: error:…:SSL routines::wrong version number transport_smtp_encrypt steht auf true. TYPO3 erwartet dann TLS ab dem ersten Byte, während Port 587 unverschlüsselt beginnt und erst danach über STARTTLS hochstuft. Setzen Sie transport_smtp_encrypt auf false und belassen Sie den Port bei 587. Die Verbindung ist dann weiterhin verschlüsselt.
Failed to authenticate on SMTP server with username "…" using the following authenticators: "LOGIN", "PLAIN". … Expected response code "235" but got code "535" Das Relay lehnt die Anmeldung ab. Entweder stimmen Benutzername oder Passwort nicht, oder die Umgebungsvariable ist in dem Kontext leer, in dem PHP läuft — der Webserver sieht nicht automatisch dieselben Variablen wie Ihre Shell. Prüfen Sie, ob getenv('SMTP_PASSWORD') innerhalb des Webservers einen Wert zurückgibt, und verwenden Sie den SMTP-Login aus Ihrem 2mail-Konto — nicht das Passwort eines Postfachs.
Expected response code "250/251/252" but got code "554", with message "554 5.7.1 <noreply@example.com>: Sender address rejected" Die Anmeldung stimmt, aber die Absenderadresse liegt auf einer Domain, die nicht mit Ihrem 2mail-Konto verknüpft ist. Oft ist defaultMailFromAddress leer, oder ein Formular setzt seinen eigenen Absender. Setzen Sie defaultMailFromAddress auf eine Adresse einer Domain, die Sie in 2mail hinzugefügt haben, und prüfen Sie pro Formular, welche Absenderadresse es verwendet.
SPF, DKIM & DMARC erklärt Über Zustellbarkeit

Andere Plattform?

SMTP ist ein Standardprotokoll: Jedes System, das SMTP spricht — ein CRM, ein ERP, eine eigene Anwendung oder ein Server —, kann über 2mail mit denselben fünf Feldern senden.

Häufige Fragen zu SMTP für TYPO3

TYPO3 versendet standardmäßig über die lokale Mailfunktion des Servers, ohne Authentifizierung und ohne Reputation. Die Nachricht geht zwar ab, wird aber unterwegs abgewiesen oder als Spam markiert, weil nichts belegt, dass sie von Ihrer Domain stammt. Ein SMTP-Relay mit korrekten SPF-, DKIM- und DMARC-Einträgen löst das.
Nein. TYPO3 unterstützt SMTP als Transport in den Installationseinstellungen. Sie stellen den Transport auf SMTP und geben Server mit Port, Verschlüsselung, Benutzername und Passwort an. Erweiterungen, die E-Mails versenden, nutzen denselben Transport.
Prüfen Sie, ob die Änderung nicht von einer zusätzlichen Konfigurationsdatei überschrieben wird und ob der Cache von TYPO3 geleert wurde. Das Install Tool zeigt Ihnen, welcher Wert tatsächlich gilt — das ist der schnellste Weg, um zu wissen, was TYPO3 wirklich liest.
In Ihrem 2mail-Konto, pro Anwendung. Sie sind kontogebunden, deshalb veröffentlichen wir sie nicht auf der Website. Legen Sie für TYPO3 am besten pro Umgebung eigene Zugangsdaten an, damit Sie Staging separat widerrufen können.
Jetzt anrufen
E-Mail senden