Nullmailer and Fakemail – two little tools for every developer

From time to time I need to work with outgoing mails: change templates, make sure they display correct data etc. You could go with some full blown MTA like postfix and it’s actually pretty easy to install and configure for outgoing mail sending. I personally tend to not install MTA on my dev box, since I may accidentally send emails to clients..

What I use instead are two little tools called Nullmailer and Fakemail


You can think of nullmailer as sendmail wrapper which just relies messages to another mail host. Most mail functions ( like PHP mail() ) expect sendmail binary installed by MTA, in our case nullmailer provides sendmail binary and as the result all mail flows through it to the mail host you configure.

On Ubuntu you can install Nullmailer pretty easily, just type:

sudo apt-get install nullmailer

Then configuration part – in most cases it’s pretty easy. On Ubuntu configs are in /etc/nullmailer.

For my dev box I just added one line to the config /etc/nullmailer/remotes:

localhost smtp ( remember I use Fakemail to capture mails and write them to a folder )

and then restart nullmailer

sudo /etc/init.d/nullmailer restart

That’s about it, at this point you should have Nullmailer forwarding mail to your local smtp port. Read on to find out how to capture outgoing emails on that port.

Tip: Sometimes it could be useful to purge nullmailer queue, that could be the case when you machine was running for a while and a bunch of mails got queued. After you connect Fakemail – nullmailer will try to deliver those. If you don’t want that – just delete those messages from /var/spool/nullmailer/queue/ ( Debian location ).


Now that we have Nullmailer forwarding mails to our smtp port ( usually 25 ) we need to capture and write those to a folder, so we could actually do some work on our newsletters.

Introducing Fakemail:

A fake mail server that captures e-mails as files for acceptance testing. This avoids the excessive configuration of setting up a real mail server and trying to extract mail queue content.

To install, just download archive from sourceforge ( I posted a link at the beginning of the post ) or google it. Then all you need to do is launch it. I use following command to start the service:

sudo /var/www/fakemail-python-1.0/build/scripts-2.7/ --port 25 --path /tmp/mails

Make sure you specify your own path to the fakemail install, also you need to create a directory where your fake mails will be stored.

At this point you should be able to send mails from your scripts and debug them on your dev box!


Progress = happiness. Feel Good Now!

I'm Sergey Khaladzinski (@gansbrest). Not so long ago, I decided to take my life to another level. If you'd like to follow my journey, feel free subscribe below to get periodic updates about my life and the new stuff I explore.

Don't be mad if you don't receive anything from me for a period of time. I'm still learning the process.. Powered by ConvertKit

Leave a Reply

Your email address will not be published. Required fields are marked *