MailHog/README.md

MailHog

Inspired by MailCatcher, easier to install.

MailHog is a rewritten version of MailHog, which was born out of M3MTA.

Go was chosen for portability - MailHog runs without installation on multiple platforms.

Requirements

• None!

Getting started

1. Either:

• Download the latest release of MailHog for your platform
• Read the deployment guide for other deployment options

2. Configure MailHog, or use the default settings:

• the SMTP server will start on port 1025
• the HTTP server will start on port 8025
• in-memory message storage will be used.

Features

• ESMTP server implementing RFC5321
• Support for SMTP AUTH (RFC4954) and PIPELINING (RFC2920)
• Web interface to view messages (plain text, HTML or source)
  • Supports RFC2047 encoded headers
• Real-time updates using EventSource
• Release messages to real SMTP servers
• Chaos Monkey for failure testing
  • See Introduction to Jim for more information
• HTTP API to list, retrieve and delete messages
  • See APIv1 documentation for more information
• Multipart MIME support
• Download individual MIME parts
• In-memory message storage
• MongoDB storage for message persistence
• Lightweight and portable
• No installation required

Contributing

Clone this repository to $GOPATH/src/github.com/mailhog/MailHog and type make deps.

See the Building MailHog guide.

Requires Go 1.2+ to build.

Run tests using make test or goconvey.

If you make any changes, run go fmt ./... before submitting a pull request.

Licence

Copyright ©‎ 2014, Ian Kent (http://www.iankent.eu).

Released under MIT license, see LICENSE for details.