Use with TYPO3 | Mailcatcher Skip to content

Use with TYPO3

TYPO3 12 and newer

Make sure to check the upstream documentation on more details about TYPO3 Mailer configuration

Configuration

TYPO3 stores its mail configuration in config/system/additional.php. Make sure your configuration only applies to the environments you enticipate, otherwise you might redirect production mails to Mailcatcher.

additional.php
// Send mails to Mailcatcher
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport'] = "smtp";
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_smtp_server'] = "mailcatcher.cloud:1026";
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_smtp_username'] = "project.tenant";
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_smtp_password'] = "your-secure-password";

up to TYPO3 11

Make sure to check the upstream documentation on more details about TYPO3 Mailer configuration

Configuration

TYPO3 stores its mail configuration in typo3conf/AdditionalConfiguration.php. Make sure your configuration only applies to the environments you enticipate, otherwise you might redirect production mails to Mailcatcher.

AdditionalConfiguration.php
// Send mails to Mailcatcher
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport'] = "smtp";
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_smtp_server'] = "mailcatcher.cloud:1026";
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_smtp_username'] = "project.tenant";
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['transport_smtp_password'] = "your-secure-password";

Test the configuration

TYPO3 can send test emails from the Install tool in the backend. The flow for this is the same in all modern TYPO3 installtions and show in TYPO3 11.

  1. Open the Environment module in the Install tool of your TYPO3 installtion.

    Dashboard showing four cards with the described metrics.
  2. Click the Test Mail Setup button in the corresponding card.

    Dashboard showing four cards with the described metrics.

    You will see a green success message when the mail could be sent successfuly.

  3. Check your project in Mailcatcher if the email arrived.

    Dashboard showing four cards with the described metrics.