Skip to main content

A fake Email Server with a Web Front End

Project description

FakeEmail is an email server, for use in a development environment where routing email is either undesirable, or impossible to manage.

The aim of the system is to open a port, accept SMTP connections and to display a list of the emails that it has received. At no point will the emails route further on, so there is no requirement for the addresses to be valid, or to wait around waiting for the email to arrive in your inbox.


Via pip

FakeEmail is installable via pip:

pip install fakeemail

From Source

FakeEmail is installed using the and depends on Twisted for it’s server capabilites. Installation is as straight forward as possible:

git clone git://
cd FakeEmail
python install



If you installed fakeemail via pip, then running is simple:

fakeemail 2025 8080

This will run on SMTP port 2025, the web interface on 8080 and listen on all network interfaces. Running on port 25 is possible, but you will need to start with root privileges.


There are two options for the system:

  • -s or –smtp_port : Which port to run the SMTP listener on (defaults to 2025)
  • -w or –web_port : Which port to run the Web Server on (defaults to 8000)

Use these options as shown below:

fakeemail -s 1025 -w 8001

Note that to run the SMTP listener on port 25 (the standard SMTP port), you may need to start the daemon with root privileges.

Once the server is running, direct any email at the port that you specified, and then load up http://<servername>:webport (http://localhost:8000 for example)


The dependencies will be installed through the egg, but if you require them to be system installed, they are listed below:

  • twisted
  • jinja2
  • python (2.4+)

Known Issues

The use of srcdoc for the iframe element of displaying HTML emails will not work in any current version of Internet Explorer.


Tom Wardill (original author) - Andrew Plummer - John Carr -

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
fakeemail-0.10.1.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None Feb 10, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page