SMTP for TYPO3 — site mail that arrives
TYPO3 sends its mail through the transport defined in the installation settings. By default that is the server's local mail function — without authentication and without reputation, which is why form submissions and password reset emails regularly end up as spam at Gmail and Outlook.
TYPO3 can set that transport directly to SMTP, without an extra extension. You enter server, port, encryption and login in the installation's MAIL settings, and everything TYPO3 sends — including form and workflow mail from extensions — goes through your relay from then on.
Why it goes wrong without a relay
TYPO3 is used for large, multilingual sites of companies and public bodies, often with forms that start a real process: a registration, a quote request, a job application. If the confirmation fails to arrive, the applicant calls — or fills in the form again and you end up with duplicate records. The mail does leave, but nothing proves it comes from your domain.
Setting up SMTP in TYPO3
Collect your details
Log in to your 2mail account and retrieve your SMTP server, username and password there.
Fill them in inside TYPO3
TYPO3's mail configuration lives in the installation settings, under the MAIL keys. Set the transport to SMTP, enter the server together with the port, choose the encryption and provide username and password. Also set the default sender address and sender name to your own domain. The install tool has a test email — send it to an external address at a major provider.
Authenticate your domain
Make sure SPF, DKIM and DMARC are set correctly for your domain, so recipients can verify that the mail comes from you.
Test
Send a test message to an address at a major provider and check that it arrives in the inbox and not in the spam folder.
The fields TYPO3 asks for
Every platform names them slightly differently, but it is always the same five. The actual values are tied to your account and can be found in your 2mail account — take them from there, so you are sure to use the right ones.
| Field | What you enter |
|---|---|
| SMTP server (host) | The server name from your 2mail account. |
| Port | The port that matches your chosen encryption; your account shows which one. |
| Encryption | TLS. Never send unencrypted — your credentials would otherwise travel in plain text. |
| Username | The SMTP login of your 2mail account. |
| Password | The matching password. Never use the password of an employee's mailbox. |
Which emails TYPO3 sends
As soon as the relay is set up, all of these run through 2mail — you do not have to configure them one by one.
Pitfalls with TYPO3
Settings in the wrong layer
TYPO3 reads the installation settings from several layers: the system configuration file and an additional file that overrides it. If you put the SMTP details in one layer while the other still holds the old transport, the latter wins. Check in the install tool which value is actually in effect.
Server and port belong together
TYPO3 expects server and port together in the transport setting. If you leave out the port, TYPO3 falls back to a default that does not match your encryption — and the connection hangs or is cut off immediately. Port 587 with STARTTLS is the safe choice.
Staging with the same details
If the configuration is deployed through version control, a test or staging environment sends with the same login — to real addresses from a copied database. Use a separate login per environment, so you can shut the test environment off on its own.
A different platform?
SMTP is a standard protocol: any system that speaks SMTP — a CRM, an ERP, a custom application or a server — can send through 2mail using the same five fields.