mailcatcher's Introduction

mailcatcher

Installation with docker

copy docker-compose.yml
change variables (see bellow)
run with "docker-compose up -d"
configure port forwarding for internet port 25 in your router (for example map internet port 25 to your Raspberry PI's port 1025)

Name	Description
MC_PORT	SMTP listening port. Must match mapped port of container.
MC_HOST	email with this host name will be accepted (typically your dyndns host name)
MC_REDIRECT_TO	destination address (all mails will be redirected to this address
MC_SENDER_MAIL	This address will be used for mail sending
MC_SMTP_HOST	use this SMTP server
MC_SMTP_PORT	with SMTP Port
MC_SMTP_USER	Authentication for SMTP server
MC_SMTP_PASSWORD	Authentication for SMTP server

If you are using GMail SMTP, please activate the usage of insecure apps on https://support.google.com/accounts/answer/6010255?hl=en .

mailcatcher's People

Hi,

I was hoping to use something exactly like this, so it's great that this already exists. Thanks for writing it!

A few things I hit getting it writing which might be helpful to someone else (if they find this error or to add to the README?)

I was using a little cloud VPS so it's not as easy to set up port forwarding like you mention, I was just going to use port 25 straight. After a lot of errors, it turns out you can't use 25:25 in the docker-compose.yml, you have to use quoted "25:25". Strange
For using GMail SMTP, you also have to turn insecure apps on https://support.google.com/accounts/answer/6010255?hl=en . I thought there was a way to have a per-application password to make it more secure but didn't look more (I'll just use a throwaway account to forward). You also have to wait 30 minutes for it percolate
When you convert incoming To: -> From: (here), I had issues if the To: email already includes a name. So if the incoming email has To: John <[email protected]> it is converted to From: John <[email protected]> <[email protected]> and GMail doesn't always appreciate two sets of brackets. I can give a PR, I don't know Golang well so I just regexp'd removed [<>] away.
A GMail fact I've hit over and over and forget each time when debugging. Maybe it'll save someone else some trouble. Say [email protected] and [email protected]. If you send from [email protected] -> [email protected] it will silently stop before it sends a duplicate back to john again. Many SMTP providers including gmail use the Message-ID to prevent loops, so it'll just silently drop the email. Using mailinator/similar as MC_REDIRECT_TO is better for the initial debugging

Recommend Projects