Skip to content
temporary e-mail address appliance including MTA and web frontend
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore EOF newlines Apr 9, 2013 Updated README to include DB setup, thanks to Björn Jul 15, 2014 EOF newlines Apr 9, 2013 python 2.6 compatibilty fix Apr 9, 2013
requirements.txt adding requirements.txt Apr 9, 2013 Next revision: web frontend works Apr 9, 2013 Clarified names Apr 9, 2013 EOF newlines Apr 9, 2013


tempmail is a temporary e-mail address provider (including SMTP server and web frontend). Basically your own Mailinator -- only that it's not blocked everywhere.


  • Small SMTPd (python/Twisted),
  • Web Frontend (python/Flask),

Notable features:

  • no-frills plaintext message display
  • no registration neccessary
  • multi-domain support
  • new mails can be deleted by anyone for 10 minutes
  • decoding MIME-encoded text

You can see a demo installation at


  1. Get a virtualenv running.
  2. Install dependencies: pip install -U -r requirements.txt
  3. Copy to and tweak the settings within
  4. Create the database tables by running python once.
  5. Start the SMTPd: twistd -y --logfile=smtpd.log
  6. Deploy the Flask-powered, see their deployment docs
  7. Forward your port 25/tcp to your chosen SMTPD_PORT, like so: iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 25 -j REDIRECT --to-port 2500
  8. Set a MX DNS record for your domain(s)

...and that's it. If you need help, you'll find me on Just /msg zakx.

You can’t perform that action at this time.