TYPO3 - Mailcatcher Docs

TYPO3 12 and above

Make sure to check the upstream documentation on more details about TYPO3 Mailer 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.

// 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 public/typo3conf/AdditionalConfiguration.php.
Make sure your configuration only applies to the environments you enticipate, otherwise you might redirect production mails to Mailcatcher.

// 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";

Testing the Integration

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

You need System Maintainer privileges or access to the TYPO3 Install tool for this.

Open the Environment module in the Install tool
Click the Test Email Setup button in the corresponding section.
Enter an email address and click Send Test Email
Check your Mailcatcher project for the captured email.

When you don’t have access to the TYPO3 Install tool, you can use any other use of the Mailer Framework in your frontend. Typical use cases might be a contact form.