Skip to content

porjo/icemail

Repository files navigation

Icemail

Build Status Coverage Status

Email catcher for development environments. Solves the problem of test emails becoming a nuisance to developers and customers.

  • acts as a 'smart relay' which by default stores all incoming mail rather than relaying it.
  • recipient addresses/domains can be whitelisted for auto-delivery, otherwise mail can be manually released via a web interface
  • single binary which does everything: mail server, mail client, web server
  • easy to install and configure

TODO

  • realtime updates as new messages arrive
  • decode HTML email content (currently displays raw text only)
  • TLS support

Setup

  • download tar file from releases page and unpack somewhere convenient
  • edit config.toml to suit
  • run with ./icemail -c config.toml
  • point browser at http://localhost:8080

By default, icemail will:

  • listen on port :2525 for SMTP connections
  • listen on port :8080 for HTTP client connections
  • forward outbound email to localhost on port :25

Credits